murmur subscriptions add

Subscribes an agent to events on specific branches or files. The agent receives matching events, such as a push to a watched branch or a change to a watched file. 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. If you omit it, the command 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), canonicalized to `https://host/owner/repo`. Auto-detected from `git remote get-url 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
`at least one of --branch or --file is required`	Neither `--branch` nor `--file` was provided.	Specify at least one of `--branch` or `--file`.
`slug is required when not running on a VM`	No slug was given on a laptop.	Provide the agent slug as a positional argument.
`unexpected positional args [...] — use --file for each file`	More than one positional argument was given.	Pass each file with its own `--file` flag.
`--repo not specified and git remote detection failed: ...`	`--repo` was omitted and `git remote get-url origin` failed.	Run inside the repository’s working tree or pass `--repo`.
`could not canonicalize repo "<value>": ...`	The repo URL could not be parsed.	Pass an HTTPS, SSH, or scp-style clone URL.
`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 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