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.

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

NameTypeRequiredDescription
slugstringon laptopThe agent’s slug. Optional on VMs (defaults to self).
--branchstringnoBranch name to subscribe to. At least one of --branch or --file is required.
--filestringnoFile path (relative to repo root) to subscribe to. 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

​
Subscribe to a branch

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.

​
Subscribe to specific files

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)

​
Subscribe with an explicit repo URL

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.

​
Self-subscribe on a VM

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

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.