murmur subscriptions ls

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. If you omit it, the command lists the current agent’s subscriptions.

Arguments

Name	Type	Required	Description
`slug`	string	on laptop	The agent’s slug. Optional on VMs (defaults to self).
`--workspace`	string	no	Workspace name. Overrides the value from `murmur.yaml`.

Output

Each subscription prints on its own line, prefixed by its type.

Prefix	Fields	Description
`branch:`	branch name, repo URL	A branch the agent is watching for push events.
`file:`	file path, repo URL, branch name	A file the agent is watching for change events.
`child:`	child agent path (slugs joined with `/`)	A 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:  director/fix-auth

Self-list on a VM

When running on an agent VM, omit the slug:

murmur subscriptions ls

Errors

Code	Meaning	What to do
`usage: murmur subscriptions ls <slug>`	No slug was given on a laptop.	Provide the agent slug as a positional argument.
`NOT_FOUND`	No agent with that slug exists.	Check the slug spelling. Use `murmur ls` to see running agents.
`UNAUTHENTICATED`	Identity token is missing or expired.	Run `murmur login` or check your `murmur.local.yaml` configuration.

Events: concept overview
Agents: concept overview
murmur subscriptions add: subscribe to branch or file events
murmur subscriptions remove: unsubscribe from specific events
murmur subscriptions flush: remove all subscriptions for an agent

Getting Started

Core Concepts

Guides

murmur subscriptions ls

Synopsis

Arguments

Output

Examples

List subscriptions

No subscriptions

Agent with child subscriptions

Self-list on a VM

Errors

​Synopsis

​Arguments

​Output

​Examples

​List subscriptions

​No subscriptions

​Agent with child subscriptions

​Self-list on a VM

​Errors

​Related

Synopsis

Arguments

Output

Examples

List subscriptions

No subscriptions

Agent with child subscriptions

Self-list on a VM

Errors

Related