Skip to main content
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

murmur ls [flags]

​
Arguments

NameTypeRequiredDescription
-aboolnoAlso include terminal (completed, failed, canceled) agents. Widens the phase filter only — it does not change which developers are listed (use -A or -developer). Default: false.
-qboolnoPrint only slugs, one per line. Default: false.
-jsonboolnoOutput as a JSON array. Default: false.
-AboolnoList all developers’ agents, not just your own. Default: false.
-developerstringnoList a specific developer’s agents by username.
-workspacestringnoWorkspace name. Overrides the value from murmur.yaml.

​
Output

The default output is a tab-aligned table with five columns:
ColumnDescription
SLUGThe agent’s slug. For child agents, displayed as parent/child.
PHASECurrent lifecycle phase — starting, running, task-complete, idle, sleeping, checks-pending, destroying, completed, failed, or canceled.
VMVM instance name. Empty if no VM is assigned.
PROGRESSLatest progress event, formatted as [label] detail (time ago). Labels include text, tool, pr, commit, and push.
COSTCumulative API cost in USD (e.g. $1.23). Empty if zero.
When no agents match, the command produces no output and exits successfully.

​
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

murmur ls

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

murmur ls -a

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

murmur ls -A

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

murmur ls -q

fix-auth
add-tests
refactor-db
Use this to kill all active agents: 
murmur ls -q | xargs -I{} murmur kill {}

​
JSON output

murmur ls -json

[
  {
    "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: 
murmur ls

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

CodeMeaningWhat to do
UNAUTHENTICATEDIdentity token is missing or expired.Run murmur auth or check your murmur.local.yaml configuration.
INVALID_ARGUMENTThe -developer value contains invalid characters.Use a plain username string without quotes or backslashes.