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 agents in the current workspace. By default, shows only your own active (non-terminal) agents. Use flags to include completed agents, other developers’ agents, or to get machine-readable output.
On a VM, murmur ls lists child agents of the current agent.
Synopsis
Arguments
| Name | Type | Required | Description |
|---|
-a | bool | no | Include completed, failed, and canceled agents. Default: false. |
-q | bool | no | Print only slugs, one per line. Default: false. |
-json | bool | no | Output as a JSON array. Default: false. |
-A | bool | no | List all developers’ agents, not just your own. Default: false. |
-developer | string | no | List a specific developer’s agents by username. |
-workspace | string | no | Workspace name. Overrides the value from murmur.yaml. |
Output
The default output is a tab-aligned table with five columns:
| Column | Description |
|---|
SLUG | The agent’s slug. For child agents, displayed as parent/child. |
PHASE | Current lifecycle phase — starting, running, task-complete, idle, sleeping, checks-pending, destroying, completed, failed, or canceled. |
VM | VM instance name. Empty if no VM is assigned. |
PROGRESS | Latest progress event, formatted as [label] detail (time ago). Labels include text, tool, pr, commit, and push. |
COST | Cumulative API cost in USD (e.g. $1.23). Empty if zero. |
Quiet mode (-q)
Prints one slug per line with no header. Useful for scripting — pipe to xargs or loop over the result.
JSON mode (-json)
Prints a JSON array of objects. Each object has slug, phase, vm, progress, progress_at, and cost fields. An empty result produces [], not null.
Examples
List active agents
SLUG PHASE VM PROGRESS COST
fix-auth running murmur-a1b2c3d4 [text] Investigating auth middleware (2m ago) $0.42
add-tests starting
refactor-db idle murmur-e5f6g7h8 [pr] https://github.com/acme/api/pull/87 (1h ago) $1.05
Include completed agents
SLUG PHASE VM PROGRESS COST
fix-auth running murmur-a1b2c3d4 [text] Investigating auth middleware (2m ago) $0.42
add-tests starting
refactor-db completed [pr] https://github.com/acme/api/pull/87 (3h ago) $1.05
old-cleanup canceled $0.10
List all developers’ agents
SLUG PHASE VM PROGRESS COST
fix-auth running murmur-a1b2c3d4 [text] Investigating auth middleware (2m ago) $0.42
alice/add-tests running murmur-f9g0h1i2 [tool] Bash, Read (30s ago) $0.88
List a specific developer’s agents
murmur ls -developer alice
Slugs only for scripting
fix-auth
add-tests
refactor-db
murmur ls -q | xargs -I{} murmur kill {}
JSON output
[
{
"slug": "fix-auth",
"phase": "running",
"vm": "murmur-a1b2c3d4",
"progress": {
"assistant_text": {
"message": "Investigating auth middleware"
}
},
"progress_at": "2026-05-14T10:30:00Z",
"cost": 0.42
}
]
Child agents on a VM
When running on an agent VM, murmur ls lists child agents spawned by the current agent:
SLUG PHASE VM PROGRESS COST
fix-auth running murmur-a1b2c3d4 [tool] Bash, Edit (15s ago) $0.30
add-tests completed [push] main (5m ago) $0.65
Errors
| Code | Meaning | What to do |
|---|
UNAUTHENTICATED | Identity token is missing or expired. | Run murmur auth or check your murmur.local.yaml configuration. |
INVALID_ARGUMENT | The -developer value contains invalid characters. | Use a plain username string without quotes or backslashes. |
