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

> List every task on an agent's checklist with ID, subject, status, and dependency edges — the same view the agent sees during planning.

Lists all [tasks](/concepts/agents) on an [agent's](/concepts/agents) checklist. By default, prints a table with each [task's](/concepts/agents) ID, subject, status, and blockers.

## Synopsis

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

On a VM, the slug is optional — omitting it lists [tasks](/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).                                                                                                                                  |
| `--json`      | bool   | no        | Output as a JSON array. Default: `false`.                                                                                                                                                                  |
| `--active`    | bool   | no        | Only show [tasks](/concepts/agents) that block exit — filters out completed [tasks](/concepts/agents) and dormant [tasks](/concepts/agents) whose activation condition has not been met. Default: `false`. |
| `--workspace` | string | no        | [Workspace](/concepts/workspaces) name. Overrides the value from `murmur.yaml`.                                                                                                                            |

## Output

### Table output (default)

A tab-separated table with four columns:

| Column       | Description                                                                                               |
| ------------ | --------------------------------------------------------------------------------------------------------- |
| `ID`         | The [task](/concepts/agents) identifier.                                                                  |
| `SUBJECT`    | Short summary of the [task](/concepts/agents).                                                            |
| `STATUS`     | One of: `TASK_STATUS_PENDING`, `TASK_STATUS_IN_PROGRESS`, `TASK_STATUS_COMPLETED`, `TASK_STATUS_DELETED`. |
| `BLOCKED_BY` | Comma-separated IDs of [tasks](/concepts/agents) that block this one. Empty if none.                      |

If the [agent](/concepts/agents) has no [tasks](/concepts/agents), the command produces no output.

### JSON output

With `--json`, the output is a JSON array of objects:

| Field        | Type      | Description                                                             |
| ------------ | --------- | ----------------------------------------------------------------------- |
| `id`         | string    | The [task](/concepts/agents) identifier.                                |
| `subject`    | string    | Short summary.                                                          |
| `status`     | string    | Lowercase status: `pending`, `in_progress`, `completed`, `deleted`.     |
| `blocked_by` | string\[] | IDs of [tasks](/concepts/agents) that block this one. Omitted if empty. |
| `activation` | string    | Activation condition in `condition:pattern` format. Omitted if none.    |

## Examples

### List all tasks

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

```
ID            SUBJECT                                   STATUS                BLOCKED_BY
t_8f3a1b2c    Add rate limiting to the login endpoint    TASK_STATUS_PENDING
t_9d4e2f1a    Run the full test suite                    TASK_STATUS_PENDING   t_8f3a1b2c
t_7c5b3a0e    Update the migration script                TASK_STATUS_COMPLETED
```

### List active tasks only

Filters out completed [tasks](/concepts/agents) and dormant conditional [tasks](/concepts/agents):

```bash theme={null}
murmur task ls fix-auth --active
```

```
ID            SUBJECT                                   STATUS                BLOCKED_BY
t_8f3a1b2c    Add rate limiting to the login endpoint    TASK_STATUS_PENDING
```

In this example, `t_9d4e2f1a` has an `--activate-when files_modified` condition that has not triggered yet, so it does not appear. `t_7c5b3a0e` is completed, so it is also excluded.

### JSON output

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

```json theme={null}
[
  {"id":"t_8f3a1b2c","subject":"Add rate limiting to the login endpoint","status":"pending"},
  {"id":"t_9d4e2f1a","subject":"Run the full test suite","status":"pending","blocked_by":["t_8f3a1b2c"],"activation":"files_modified:**/*_test.go"},
  {"id":"t_7c5b3a0e","subject":"Update the migration script","status":"completed"}
]
```

### Self-list on a VM

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

```bash theme={null}
murmur task ls
```

## Errors

| Code              | Meaning                                             | What to do                                                                                     |
| ----------------- | --------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| `NOT_FOUND`       | No [agent](/concepts/agents) with that slug exists. | Check the slug spelling. Use [`murmur ls`](/cli/ls) to see 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 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 get`](/cli/task-get) — retrieve details for a single [task](/concepts/agents)
* [`murmur status`](/cli/status) — query [agent](/concepts/agents) status
* [`murmur ls`](/cli/ls) — list running [agents](/concepts/agents)