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. If you omit it, the command 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), 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

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
`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 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