murmur subscriptions remove

Removes specific event subscriptions from an agent. You can remove a branch subscription, one or more file subscriptions, or both at once. To remove all subscriptions at once, use murmur subscriptions flush instead.

Synopsis

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

On a VM, the slug is optional — omitting it unsubscribes 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 unsubscribe from. At least one of `--branch` or `--file` is required.
`--file`	string	no	File path (relative to repo root) to unsubscribe from. 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

Remove a branch subscription

murmur subscriptions remove fix-auth --branch main

unsubscribed fix-auth from branch main

The agent fix-auth no longer receives events from pushes to main.

Remove file subscriptions

murmur subscriptions remove fix-auth --file src/auth.go --file src/middleware.go

unsubscribed fix-auth from 2 file(s)

Remove both branch and file subscriptions

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

unsubscribed fix-auth from branch main and 1 file(s)

Self-unsubscribe on a VM

When running on an agent VM, omit the slug:

murmur subscriptions remove --branch main

unsubscribed self from branch main

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 add — subscribe to branch or file events
murmur subscriptions flush — remove all subscriptions for an agent
murmur subscriptions ls — list an agent’s subscriptions

Getting Started

Core Concepts

Guides

murmur subscriptions remove

Synopsis

Arguments

Examples

Remove a branch subscription

Remove file subscriptions

Remove both branch and file subscriptions

Self-unsubscribe on a VM

Errors

​Synopsis

​Arguments

​Examples

​Remove a branch subscription

​Remove file subscriptions

​Remove both branch and file subscriptions

​Self-unsubscribe on a VM

​Errors

​Related

Synopsis

Arguments

Examples

Remove a branch subscription

Remove file subscriptions

Remove both branch and file subscriptions

Self-unsubscribe on a VM

Errors

Related