Skip to main content

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.

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

NameTypeRequiredDescription
slugstringon laptopThe agent’s slug. Optional on VMs (defaults to self).
--jsonboolnoOutput as a JSON array. Default: false.
--activeboolnoOnly show tasks that block exit — filters out completed tasks and dormant tasks whose activation condition has not been met. Default: false.
--workspacestringnoWorkspace name. Overrides the value from murmur.yaml.

​
Output

​
Table output (default)

A tab-separated table with four columns:
ColumnDescription
IDThe task identifier.
SUBJECTShort summary of the task.
STATUSOne of: TASK_STATUS_PENDING, TASK_STATUS_IN_PROGRESS, TASK_STATUS_COMPLETED, TASK_STATUS_DELETED.
BLOCKED_BYComma-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:
FieldTypeDescription
idstringThe task identifier.
subjectstringShort summary.
statusstringLowercase status: pending, in_progress, completed, deleted.
blocked_bystring[]IDs of tasks that block this one. Omitted if empty.
activationstringActivation 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

CodeMeaningWhat to do
NOT_FOUNDNo agent with that slug exists.Check the slug spelling. Use murmur ls to see running agents.
UNAUTHENTICATEDIdentity token is missing or expired.Run murmur auth or check your murmur.local.yaml configuration.