> ## 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 task get

> Retrieve the full details of a single task from an agent's checklist — subject, description, status, dependency edges, and change history.

Retrieves the full details of a single [task](/concepts/agents) from an [agent's](/concepts/agents) checklist — ID, subject, status, description, and dependency edges.

## Synopsis

```bash theme={null}
murmur task get [flags] [slug] <task-id>
```

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

## Arguments

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

## Output

The output is a set of key-value lines. Fields appear only when they have a value.

| Field         | Description                                                                              |
| ------------- | ---------------------------------------------------------------------------------------- |
| `ID`          | The [task](/concepts/agents) identifier.                                                 |
| `Subject`     | Short summary of the [task](/concepts/agents).                                           |
| `Status`      | The [task's](/concepts/agents) current status enum (e.g. `TASK_STATUS_PENDING`).         |
| `Description` | Detailed description. Only shown if set.                                                 |
| `Blocks`      | Comma-separated IDs of [tasks](/concepts/agents) this one blocks. Only shown if set.     |
| `Blocked By`  | Comma-separated IDs of [tasks](/concepts/agents) that block this one. Only shown if set. |

## Examples

### Get a task with no dependencies

```bash theme={null}
murmur task get fix-auth t_8f3a1b2c
```

```
ID:          t_8f3a1b2c
Subject:     Add rate limiting to the login endpoint
Status:      TASK_STATUS_PENDING
Description: Limit to 5 attempts per minute per IP
```

### Get a task with dependency edges

```bash theme={null}
murmur task get fix-auth t_9d4e2f1a
```

```
ID:          t_9d4e2f1a
Subject:     Run the full test suite
Status:      TASK_STATUS_PENDING
Blocked By:  t_8f3a1b2c
```

### Self-query on a VM

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

```bash theme={null}
murmur task get t_8f3a1b2c
```

## Errors

| Code              | Meaning                                                                                            | What to do                                                                                                                      |
| ----------------- | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `NOT_FOUND`       | No [agent](/concepts/agents) with that slug exists, or the [task](/concepts/agents) ID is invalid. | Check the slug and [task](/concepts/agents) ID. Use [`murmur task ls`](/cli/task-ls) to see existing [tasks](/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 task create`](/cli/task-create) — add a [task](/concepts/agents) to an [agent's](/concepts/agents) checklist
* [`murmur task update`](/cli/task-update) — change a [task's](/concepts/agents) status, subject, or dependencies
* [`murmur task ls`](/cli/task-ls) — list all [tasks](/concepts/agents) on an [agent's](/concepts/agents) checklist
* [`murmur status`](/cli/status) — query [agent](/concepts/agents) status