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

> Set how a running agent drains its follow-up queue — eager, batched, or end-of-turn — to control when queued messages are delivered.

Sets the dequeue strategy for a running [agent's](/concepts/agents) follow-up queue. The strategy controls how many queued follow-ups the [agent](/concepts/agents) pulls in per turn.

## Synopsis

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

## Arguments

| Name          | Type   | Required | Description                                                                     |
| ------------- | ------ | -------- | ------------------------------------------------------------------------------- |
| `slug`        | string | yes      | The [agent's](/concepts/agents) slug.                                           |
| `strategy`    | string | yes      | One of `auto`, `all`, `one`, or `five`. See [Strategies](#strategies) below.    |
| `--workspace` | string | no       | [Workspace](/concepts/workspaces) name. Overrides the value from `murmur.yaml`. |

## Strategies

| Value  | Behavior                                                                                                                                                                   |
| ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `auto` | Drain up to five follow-ups of one kind per turn; manual follow-ups and auto-generated events (PR comments, CI results, conflict resolutions) never share a turn. Default. |
| `all`  | Drain all queued follow-ups into one batch.                                                                                                                                |
| `one`  | Drain one follow-up per turn.                                                                                                                                              |
| `five` | Drain up to five follow-ups per turn.                                                                                                                                      |

## Examples

### Drain one follow-up per turn

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

```
dequeue strategy set to one for fix-auth
```

The [agent](/concepts/agents) now processes queued follow-ups one at a time instead of batching them.

### Restore the default behavior

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

```
dequeue strategy set to auto for fix-auth
```

## 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.                     |
| `invalid strategy` | The strategy value is not `auto`, `all`, `one`, or `five`. | Pass one of the supported strategies listed above.                                     |

## Related

* [Agents](/concepts/agents) — concept overview
* [`murmur queue add`](/cli/queue-add) — send a follow-up to an agent
* [`murmur queue clear`](/cli/queue-clear) — discard all queued follow-ups
* [`murmur queue conflict-resolution`](/cli/queue-conflict-resolution) — set per-repo conflict handling
* [`murmur status`](/cli/status) — check an agent's phase and queue