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 — omitting it 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 tasks and dormant tasks whose activation condition has not been met. Default: `false`.
`--workspace`	string	no	Workspace name. Overrides the value from `murmur.yaml`.

Output

Table output (default)

A tab-separated 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_DELETED`.
`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 JSON array of objects:

Field	Type	Description
`id`	string	The task identifier.
`subject`	string	Short summary.
`status`	string	Lowercase status: `pending`, `in_progress`, `completed`, `deleted`.
`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
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 and dormant conditional tasks:

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

murmur task ls fix-auth --json

[
  {"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 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 auth` 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