Skip to main content
Lists every event subscription for an agent — branches, files, and child agents. Prints no subscriptions if the agent has none.

​
Synopsis

murmur subscriptions ls [flags] [slug]
On a VM, the slug is optional — omitting it lists the current agent’s subscriptions.

​
Arguments

NameTypeRequiredDescription
slugstringon laptopThe agent’s slug. Optional on VMs (defaults to self).
--workspacestringnoWorkspace name. Overrides the value from murmur.yaml.

​
Output

Each subscription prints on its own line, prefixed by its type.
PrefixFieldsDescription
branch:branch name, repo URLA branch the agent is watching for push events.
file:file path, repo URL, branch nameA file the agent is watching for change events.
child:child agent identifierA child agent whose lifecycle events this agent receives.

​
Examples

​
List subscriptions

murmur subscriptions ls fix-auth

branch: main (repo: https://github.com/acme/backend)
file:   src/auth.go (repo: https://github.com/acme/backend, branch: main)
file:   src/middleware.go (repo: https://github.com/acme/backend, branch: main)

​
No subscriptions

murmur subscriptions ls idle-agent

no subscriptions

​
Agent with child subscriptions

murmur subscriptions ls director

branch: main (repo: https://github.com/acme/backend)
child:  github_oauth/alice/w/backend/director/fix-auth

​
Self-list on a VM

When running on an agent VM, omit the slug: 
murmur subscriptions ls

​
Errors

CodeMeaningWhat to do
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.