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

> List every event subscription registered for a running agent — the repository, event type, and filter expression for each active subscription.

Lists every [event](/concepts/events) subscription for an [agent](/concepts/agents) — branches, files, and child [agents](/concepts/agents). Prints `no subscriptions` if the [agent](/concepts/agents) has none.

## Synopsis

```bash theme={null}
murmur subscriptions ls [flags] [slug]
```

On a VM, the slug is optional — omitting it lists the current [agent](/concepts/agents)'s subscriptions.

## Arguments

| Name          | Type   | Required  | Description                                                                     |
| ------------- | ------ | --------- | ------------------------------------------------------------------------------- |
| `slug`        | string | on laptop | The [agent](/concepts/agents)'s slug. Optional on VMs (defaults to self).       |
| `--workspace` | string | no        | [Workspace](/concepts/workspaces) name. Overrides the value from `murmur.yaml`. |

## Output

Each subscription prints on its own line, prefixed by its type.

| Prefix    | Fields                                     | Description                                                                                                           |
| --------- | ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------- |
| `branch:` | branch name, repo URL                      | A branch the [agent](/concepts/agents) is watching for push [events](/concepts/events).                               |
| `file:`   | file path, repo URL, branch name           | A file the [agent](/concepts/agents) is watching for change [events](/concepts/events).                               |
| `child:`  | child [agent](/concepts/agents) identifier | A child [agent](/concepts/agents) whose lifecycle [events](/concepts/events) this [agent](/concepts/agents) receives. |

## Examples

### List subscriptions

```bash theme={null}
murmur subscriptions ls fix-auth
```

```
branch: main (repo: https://github.com/acme/backend)
file:   src/auth.go (repo: https://github.com/acme/backend, branch: main)
file:   src/middleware.go (repo: https://github.com/acme/backend, branch: main)
```

### No subscriptions

```bash theme={null}
murmur subscriptions ls idle-agent
```

```
no subscriptions
```

### Agent with child subscriptions

```bash theme={null}
murmur subscriptions ls director
```

```
branch: main (repo: https://github.com/acme/backend)
child:  github_oauth/alice/w/backend/director/fix-auth
```

### Self-list on a VM

When running on an [agent](/concepts/agents) VM, omit the slug:

```bash theme={null}
murmur subscriptions ls
```

## Errors

| Code               | Meaning                                             | What to do                                                                                     |
| ------------------ | --------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| `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 remove`](/cli/subscriptions-remove) — unsubscribe from specific [events](/concepts/events)
* [`murmur subscriptions flush`](/cli/subscriptions-flush) — remove all subscriptions for an [agent](/concepts/agents)