Skip to main content
Lists agent tasks. Returns the slug, phase, VM assignment, progress, and cost for each task. By default shows only active tasks for the calling developer. Two independent scopes control the result: developer selects which accounts are listed, and include_terminal selects which phases are listed. include_terminal never widens the set of accounts — to see other developers’ agents, set developer. Equivalent to murmur ls in the CLI.

​
Parameters

NameTypeRequiredDescription
include_terminalbooleannoAlso include agents in terminal states (completed, failed, canceled). Widens the phase filter only — it does not change which accounts are listed (use developer for that). Default: false (live agents only).
developerstringnoWhich accounts to list — the only way to widen account scope. "" (default) lists only the calling account’s agents; * lists every account; alice lists one specific account.
workspacestringnoWorkspace name. Overrides the session default.

​
Response

Returns a JSON array of agent summary objects.
FieldTypeDescription
slugstringAgent task slug.
phasestringCurrent lifecycle phase (e.g. PHASE_RUNNING, PHASE_TASK_COMPLETE).
vmobjectVM instance name, project, zone.
progressobjectLatest progress update — label, detail, timestamp.
costnumberCumulative cost in USD.

​
Examples

​
List active agents

{}
Response: 
[
  {
    "slug": "fix-auth",
    "phase": "PHASE_RUNNING",
    "vm": {"instanceName": "murmur-a1b2c3d4", "project": "acme-agents", "zone": "us-central1-a"},
    "progress": {"label": "tool", "detail": "Running tests", "timestamp": "2026-05-14T10:30:00Z"},
    "cost": 0.42
  }
]

​
Include completed agents

{
  "include_terminal": true
}

​
All developers in a workspace

{
  "developer": "*",
  "workspace": "backend"
}

​
Errors

CodeMeaningWhat to do
UNAUTHENTICATEDIdentity token is missing or expired.Check credentials.
  • murmur ls — equivalent CLI command
  • status — detailed status for a single agent
  • spawn — create an agent
  • kill — cancel an agent