murmur task ls

Lists all tasks on an agent’s checklist. By default, prints a table with each task’s ID, subject, status, and blockers.

Synopsis

murmur task ls [flags] [slug]

On a VM, the slug is optional. If you omit it, the command lists tasks on the current agent’s own checklist.

Arguments

Name	Type	Required	Description
`slug`	string	on laptop	The agent’s slug. Optional on VMs (defaults to self).
`--json`	bool	no	Output as a JSON array. Default: `false`.
`--active`	bool	no	Only show tasks that block exit: filters out completed and not-applicable tasks and dormant tasks whose activation condition has not been met in the current run. The current run comes from `MURMUR_RUN_ID`, so off a VM every conditional task counts as dormant. Default: `false`.
`--workspace`	string	no	Workspace name. Overrides the value from `murmur.yaml`.

Output

Table output (default)

A column-aligned table with four columns:

Column	Description
`ID`	The task identifier.
`SUBJECT`	Short summary of the task.
`STATUS`	One of: `TASK_STATUS_PENDING`, `TASK_STATUS_IN_PROGRESS`, `TASK_STATUS_COMPLETED`, `TASK_STATUS_NOT_APPLICABLE`.
`BLOCKED_BY`	Comma-separated IDs of tasks that block this one. Empty if none.

If the agent has no tasks, the command produces no output.

JSON output

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

Field	Type	Description
`id`	string	The task identifier.
`subject`	string	Short summary.
`status`	string	Lowercase status: `pending`, `in_progress`, `completed`, `not_applicable`.
`not_applicable_reason`	string	Why the task does not apply. Omitted if empty.
`blocked_by`	string[]	IDs of tasks that block this one. Omitted if empty.
`activation`	string	Activation condition in `condition:pattern` format. Omitted if none.

Examples

List all tasks

murmur task ls fix-auth

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

List active tasks only

Filters out completed tasks and dormant conditional tasks:

murmur task ls fix-auth --active

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

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

JSON output

murmur task ls fix-auth --json

[{"id":"1","subject":"Add rate limiting to the login endpoint","status":"pending"},{"id":"2","subject":"Run the full test suite","status":"pending","blocked_by":["1"],"activation":"files_modified:**/*_test.go"},{"id":"3","subject":"Update the migration script","status":"completed"}]

Self-list on a VM

When running on an agent VM, omit the slug:

murmur task ls

Errors

Code	Meaning	What to do
`NOT_FOUND`	No agent with that slug exists.	Check the slug spelling. Use `murmur ls` to see running agents.
`UNAUTHENTICATED`	Identity token is missing or expired.	Run `murmur login` or check your `murmur.local.yaml` configuration.

Agents: concept overview
murmur task create: add a task to an agent’s checklist
murmur task update: change a task’s status, subject, or dependencies
murmur task get: retrieve details for a single task
murmur status: query agent status
murmur ls: list running agents

Getting Started

Core Concepts

Guides

murmur task ls

Synopsis

Arguments

Output

Table output (default)

JSON output

Examples

List all tasks

List active tasks only

JSON output

Self-list on a VM

Errors

​Synopsis

​Arguments

​Output

​Table output (default)

​JSON output

​Examples

​List all tasks

​List active tasks only

​JSON output

​Self-list on a VM

​Errors

​Related

Synopsis

Arguments

Output

Table output (default)

JSON output

Examples

List all tasks

List active tasks only

JSON output

Self-list on a VM

Errors

Related