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 agent tasks. Returns the slug, phase, VM assignment, progress, and cost for each task. By default shows only active tasks for the calling developer. Equivalent to murmur ls in the CLI.

Parameters

NameTypeRequiredDescription
allbooleannoInclude completed and failed workflows. Default: false.
developerstringnoFilter to a specific developer login, or * for all developers. Empty means caller only.
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

{
  "all": 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