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

> Send a follow-up message to a running agent's task queue — delivered after the current turn finishes or according to the active queue strategy.

Sends a follow-up message to a running [agent's](/concepts/agents) queue. The [agent](/concepts/agents) picks up queued follow-ups between tasks — use this to give an [agent](/concepts/agents) additional work after it finishes its current task, or to steer it while it is idle or sleeping. A follow-up wakes a [sleeping](/concepts/agents) [agent](/concepts/agents).

## Synopsis

```bash theme={null}
murmur queue add [flags] <slug> <description>
```

The description is everything after the slug. Multiple words are joined with spaces.

## Arguments

| Name          | Type   | Required | Description                                                                                                 |
| ------------- | ------ | -------- | ----------------------------------------------------------------------------------------------------------- |
| `slug`        | string | yes      | The [agent's](/concepts/agents) slug.                                                                       |
| `description` | string | yes      | The follow-up message. All remaining arguments after the slug are joined into the description.              |
| `--agent`     | string | no       | Override the [agent persona](/concepts/agent-personas) for this follow-up (e.g. `programmer`, `architect`). |
| `--task`      | string | no       | A checklist item to include. Repeatable — pass `--task` multiple times to build a checklist.                |
| `--workspace` | string | no       | [Workspace](/concepts/workspaces) name. Overrides the value from `murmur.yaml`.                             |

## Examples

### Send a follow-up message

```bash theme={null}
murmur queue add fix-auth Now add integration tests for the JWT middleware
```

```
Follow-up sent to fix-auth
```

The [agent](/concepts/agents) receives this message after completing its current task.

### Follow-up with a checklist

```bash theme={null}
murmur queue add fix-auth Harden the auth layer --task "Add expiry validation tests" --task "Add malformed token tests" --task "Update the README"
```

```
Follow-up sent to fix-auth
```

The [agent](/concepts/agents) receives the description along with a structured checklist of tasks.

### Override the persona

```bash theme={null}
murmur queue add fix-auth Review the PR for security issues --agent architect
```

```
Follow-up sent to fix-auth
```

The [agent](/concepts/agents) processes the follow-up using the `architect` [persona](/concepts/agent-personas) instead of its default.

## 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
* [Agent personas](/concepts/agent-personas) — persona configuration
* [`murmur queue clear`](/cli/queue-clear) — discard all queued follow-ups
* [`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 notify`](/cli/notify) — send a one-off message without queuing
* [`murmur status`](/cli/status) — check an agent's phase and queued follow-ups
* [`murmur watch`](/cli/watch) — stream events for an agent in real time