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

> Print an agent's folded turns — one block per task run, with the inputs that triggered it, the agent's response, and any error.

Prints an [agent's](/concepts/agents) turns: one block per task run, in run order. Each turn shows what triggered the run (your initial prompt, a follow-up, a PR comment, a PR review, a CI result), the agent's written response, and an error if the run failed. Use it to read back what an agent did and why, without opening the dashboard.

A turn is the unit the dashboard's [Turns view](/guides/dashboard) renders. `murmur turns` reads the same data from the command line.

## Synopsis

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

The `slug` is optional — omit it to read the turns of the agent resolved from your current context (on a VM, the agent itself).

## Arguments

| Name          | Type   | Required | Description                                                                                                                                                                                                                        |
| ------------- | ------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `slug`        | string | no       | The [agent](/concepts/agents) to read. Accepts the same relative and absolute slug forms as [`murmur status`](/cli/status). Omit to use the current context's agent.                                                               |
| `--scope`     | string | no       | Which executions to include: `current` (the latest execution only) or `all` (every execution of the slug). Empty uses the server default for the slug — the current execution for a `--force-new` spawn, all executions otherwise. |
| `--json`      | bool   | no       | Output the turns as a JSON array of Turn objects instead of formatted text. Default: `false`.                                                                                                                                      |
| `--workspace` | string | no       | [Workspace](/concepts/workspaces) name. Overrides the value in `murmur.yaml`.                                                                                                                                                      |

## Output

Each turn renders as a block: a header with the run number and its start and end times (UTC), the task description, each input with its kind and label, the agent's response, and an error line if the run failed. An in-flight turn shows `(in flight)` for its end time.

```
turn 1  2026-06-09 11:42:10 → 2026-06-09 11:58:04
  description: Fix the flaky test in auth_test.go
  response:
    Root-caused the flake to a shared clock. Pinned it and pushed the fix.

turn 2  2026-06-09 12:01:05 → 2026-06-09 12:08:33
  input [pr-comment] PR comment from alice
    please also cover the refresh-token path
  response:
    Added a refresh-token case and re-ran the suite — all green.
```

With `--json`, the command prints a JSON array of Turn objects:

```bash theme={null}
murmur turns --json fix-auth
```

```json theme={null}
[
  {
    "runId": "1",
    "description": "Fix the flaky test in auth_test.go",
    "response": "Root-caused the flake to a shared clock. Pinned it and pushed the fix.",
    "startedAt": "2026-06-09T11:42:10Z",
    "completedAt": "2026-06-09T11:58:04Z"
  }
]
```

## Examples

### Read an agent's turns

```bash theme={null}
murmur turns fix-auth
```

### Read every execution of a slug

```bash theme={null}
murmur turns --scope all fix-auth
```

Includes turns from prior executions — useful after a `--resurrect` or `--force-new` spawn reused the slug.

### Read the current agent's turns on a VM

```bash theme={null}
murmur turns
```

## Errors

| Code              | Meaning                                        | What to do                                                        |
| ----------------- | ---------------------------------------------- | ----------------------------------------------------------------- |
| `invalid scope`   | The `--scope` value is not `current` or `all`. | Pass `current`, `all`, or omit the flag.                          |
| `UNAUTHENTICATED` | Identity token is missing or expired.          | Run [`murmur auth`](/cli/auth) or check your `murmur.local.yaml`. |

## Related

* [`murmur status`](/cli/status) — the agent's current phase and summary
* [`murmur watch`](/cli/watch) — stream live agent state
* [`murmur session watch`](/cli/session-watch) — follow the raw session stream
* [Events](/concepts/events) — the triggers that start new turns
* [Dashboard](/guides/dashboard) — the Turns view this command mirrors