Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.murmur.dev/llms.txt

Use this file to discover all available pages before exploring further.

Removes specific event subscriptions from an agent. You can remove a branch subscription, one or more file subscriptions, or both at once. To remove all subscriptions at once, use murmur subscriptions flush instead.

Synopsis

murmur subscriptions remove [slug] [--branch <branch>] [--file <path>]... [--repo <clone-url>] [--workspace <ws>]
On a VM, the slug is optional — omitting it unsubscribes the current agent.

Arguments

NameTypeRequiredDescription
slugstringon laptopThe agent’s slug. Optional on VMs (defaults to self).
--branchstringnoBranch name to unsubscribe from. At least one of --branch or --file is required.
--filestringnoFile path (relative to repo root) to unsubscribe from. Repeatable. At least one of --branch or --file is required.
--repostringnoRepository URL (HTTPS, SSH, or scp-style). Auto-detected from git remote origin if omitted.
--workspacestringnoWorkspace name. Overrides the value from murmur.yaml.

Examples

Remove a branch subscription

murmur subscriptions remove fix-auth --branch main
unsubscribed fix-auth from branch main
The agent fix-auth no longer receives events from pushes to main.

Remove file subscriptions

murmur subscriptions remove fix-auth --file src/auth.go --file src/middleware.go
unsubscribed fix-auth from 2 file(s)

Remove both branch and file subscriptions

murmur subscriptions remove fix-auth --branch main --file src/auth.go
unsubscribed fix-auth from branch main and 1 file(s)

Self-unsubscribe on a VM

When running on an agent VM, omit the slug:
murmur subscriptions remove --branch main
unsubscribed self from branch main

Errors

CodeMeaningWhat to do
INVALID_ARGUMENTNeither --branch nor --file was provided.Specify at least one of --branch or --file.
INVALID_ARGUMENTSlug is required when not running on a VM.Provide the agent slug as a positional argument.
NOT_FOUNDNo agent with that slug exists.Check the slug spelling. Use murmur ls to see running agents.
UNAUTHENTICATEDIdentity token is missing or expired.Run murmur auth or check your murmur.local.yaml configuration.