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
| Name | Type | Required | Description |
|---|
all | boolean | no | Include completed and failed workflows. Default: false. |
developer | string | no | Filter to a specific developer login, or * for all developers. Empty means caller only. |
workspace | string | no | Workspace name. Overrides the session default. |
Response
Returns a JSON array of agent summary objects.
| Field | Type | Description |
|---|
slug | string | Agent task slug. |
phase | string | Current lifecycle phase (e.g. PHASE_RUNNING, PHASE_TASK_COMPLETE). |
vm | object | VM instance name, project, zone. |
progress | object | Latest progress update — label, detail, timestamp. |
cost | number | Cumulative 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 developers in a workspace
{
"developer": "*",
"workspace": "backend"
}
Errors
| Code | Meaning | What to do |
|---|
UNAUTHENTICATED | Identity 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