murmur subscriptions add

Subscribes an agent to events on specific branches or files. When a matching event occurs — a push to a watched branch, or a change to a watched file — the agent receives it. You can subscribe to a branch, one or more files, or both at once. Each --file flag adds a separate file subscription.

Synopsis

murmur subscriptions add [slug] [--branch <branch>] [--file <path>]... [--repo <clone-url>] [--workspace <ws>]

On a VM, the slug is optional — omitting it subscribes the current agent.

Arguments

Name	Type	Required	Description
`slug`	string	on laptop	The agent’s slug. Optional on VMs (defaults to self).
`--branch`	string	no	Branch name to subscribe to. At least one of `--branch` or `--file` is required.
`--file`	string	no	File path (relative to repo root) to subscribe to. Repeatable. At least one of `--branch` or `--file` is required.
`--repo`	string	no	Repository URL (HTTPS, SSH, or scp-style). Auto-detected from `git remote origin` if omitted.
`--workspace`	string	no	Workspace name. Overrides the value from `murmur.yaml`.

Examples

murmur subscriptions add fix-auth --branch main

subscribed fix-auth to branch main

The agent fix-auth now receives events whenever commits are pushed to main.

murmur subscriptions add fix-auth --branch main --file src/auth.go --file src/middleware.go

subscribed fix-auth to branch main and 2 file(s)

murmur subscriptions add fix-auth --branch develop --repo https://github.com/acme/backend

subscribed fix-auth to branch develop

Use --repo when you are not inside the repository’s working tree, or when you want to subscribe to events in a different repository. When running on an agent VM, omit the slug to subscribe the current agent:

murmur subscriptions add --branch main --file README.md

subscribed self to branch main and 1 file(s)

Errors

Code	Meaning	What to do
`INVALID_ARGUMENT`	Neither `--branch` nor `--file` was provided.	Specify at least one of `--branch` or `--file`.
`INVALID_ARGUMENT`	Slug is required when not running on a VM.	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 auth` or check your `murmur.local.yaml` configuration.

Events — concept overview
Agents — concept overview
murmur subscriptions remove — unsubscribe from branch or file events
murmur subscriptions flush — remove all subscriptions for an agent
murmur subscriptions ls — list an agent’s subscriptions
murmur status — query an agent’s current status

Getting Started

Core Concepts

Guides

murmur subscriptions add

Synopsis

Arguments

Examples

Errors

​Synopsis

​Arguments

​Examples

​Subscribe to a branch

​Subscribe to specific files

​Subscribe with an explicit repo URL

​Self-subscribe on a VM

​Errors

​Related

Synopsis

Arguments

Examples

Subscribe to a branch

Subscribe to specific files

Subscribe with an explicit repo URL

Self-subscribe on a VM

Errors

Related