> ## 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 queue clear

> Discard all queued follow-ups for a running agent without delivering them — useful when re-prioritizing or recovering from bad instructions.

Discards all queued follow-up messages for an [agent](/concepts/agents). The [agent](/concepts/agents) never receives the cleared messages. Returns the number of follow-ups that were discarded.

## Synopsis

```bash theme={null}
murmur queue clear [flags] [slug]
```

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

## Arguments

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

## Examples

### Clear an agent's queue

```bash theme={null}
murmur queue clear fix-auth
```

```
cleared 3 follow-ups
```

All pending follow-ups are discarded. The [agent](/concepts/agents) continues with its current task but receives no further queued messages.

### Clear when nothing is queued

```bash theme={null}
murmur queue clear fix-auth
```

```
cleared 0 follow-ups
```

### Self-clear on a VM

When running on an [agent](/concepts/agents) VM, omit the slug to clear the current [agent's](/concepts/agents) own queue:

```bash theme={null}
murmur queue clear
```

## Errors

| Code              | Meaning                                             | What to do                                                                             |
| ----------------- | --------------------------------------------------- | -------------------------------------------------------------------------------------- |
| `NOT_FOUND`       | No [agent](/concepts/agents) with that slug exists. | Check the slug. Use [`murmur ls`](/cli/ls) to list running [agents](/concepts/agents). |
| `UNAUTHENTICATED` | Identity token is missing or expired.               | Run `murmur auth` or check your `murmur.local.yaml` configuration.                     |

## Related

* [Agents](/concepts/agents) — concept overview
* [`murmur queue add`](/cli/queue-add) — send a follow-up to an agent
* [`murmur queue strategy`](/cli/queue-strategy) — set how follow-ups are drained
* [`murmur queue conflict-resolution`](/cli/queue-conflict-resolution) — set per-repo conflict handling
* [`murmur status`](/cli/status) — check an agent's phase and queued follow-ups
* [`murmur notify`](/cli/notify) — send a one-off message without queuing