> ## 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.

# murmur subscriptions remove

> Unsubscribe an agent from specific branch, file, or PR events in a given repository — leaves other subscriptions for the agent intact.

Removes specific [event](/concepts/events) subscriptions from an [agent](/concepts/agents). 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`](/cli/subscriptions-flush) instead.

## Synopsis

```bash theme={null}
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](/concepts/agents).

## Arguments

| Name          | Type   | Required  | Description                                                                                                            |
| ------------- | ------ | --------- | ---------------------------------------------------------------------------------------------------------------------- |
| `slug`        | string | on laptop | The [agent](/concepts/agents)'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](/concepts/workspaces) name. Overrides the value from `murmur.yaml`.                                        |

## Examples

### Remove a branch subscription

```bash theme={null}
murmur subscriptions remove fix-auth --branch main
```

```
unsubscribed fix-auth from branch main
```

The [agent](/concepts/agents) `fix-auth` no longer receives [events](/concepts/events) from pushes to `main`.

### Remove file subscriptions

```bash theme={null}
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

```bash theme={null}
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](/concepts/agents) VM, omit the slug:

```bash theme={null}
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](/concepts/agents) slug as a positional argument.                           |
| `NOT_FOUND`        | No [agent](/concepts/agents) with that slug exists. | Check the slug spelling. Use [`murmur ls`](/cli/ls) to see running [agents](/concepts/agents). |
| `UNAUTHENTICATED`  | Identity token is missing or expired.               | Run `murmur auth` or check your `murmur.local.yaml` configuration.                             |

## Related

* [Events](/concepts/events) — concept overview
* [Agents](/concepts/agents) — concept overview
* [`murmur subscriptions add`](/cli/subscriptions-add) — subscribe to branch or file [events](/concepts/events)
* [`murmur subscriptions flush`](/cli/subscriptions-flush) — remove all subscriptions for an [agent](/concepts/agents)
* [`murmur subscriptions ls`](/cli/subscriptions-ls) — list an [agent](/concepts/agents)'s subscriptions