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.
Queries an agent’s current state. Returns the phase, VM assignment, progress, output (PRs, commits, cost), and optionally child statuses and lifecycle timeline.
Equivalent to murmur status in the CLI.
Parameters
| Name | Type | Required | Description |
|---|
slug | string | yes | Agent task slug (e.g. fix-bug). Use an absolute path like /w/workspace/u/account/slug to target an agent outside your own path. |
children | boolean | no | Include child agent statuses in the response. Default: false. |
timeline | string[] | no | Timeline event types to include. Omit to exclude timeline. |
workspace | string | no | Workspace name. Overrides the session default. |
Timeline event types
| Type | What it captures |
|---|
phase | Phase transitions (starting → running → task-complete → idle). |
child | Child agent lifecycle changes. |
taskComplete | Agent finished a task turn. |
commit | Agent made a git commit. |
push | Agent pushed to remote. |
checks | CI check status updates. |
followUp | Follow-up messages delivered to the agent. |
upload | File uploads. |
Response
Returns the agent’s full status as a JSON object. Fields are present only when they have a value.
| Field | Type | Description |
|---|
agentId | object | The agent’s identity — tenant, account, workspace, slug path. |
phase | string | Current lifecycle phase (e.g. PHASE_RUNNING, PHASE_TASK_COMPLETE). |
vm | object | VM instance name, project, zone. |
vmStopped | boolean | true when the VM is stopped (sleeping). |
version | string | The murmur version running on the VM. |
progress | object | Latest progress update — label, detail, timestamp. |
sessionMode | string | SESSION_MODE_INTERACTIVE for interactive sessions. |
currentDescription | string | The agent’s current task description. |
queuedFollowUps | string[] | Pending follow-up messages. |
output | object | Agent output — response text, prs array, commits count, cost in USD. |
children | object[] | Child agent statuses (only when children: true). |
timeline | object[] | Lifecycle events (only when timeline is set). |
Examples
Basic status check
Response:
{
"agentId": {
"tenant": {"provider": "PROVIDER_GITHUB_OAUTH", "org": "alice"},
"ownerProvider": "PROVIDER_GITHUB_OAUTH",
"account": "alice",
"workspace": "backend",
"agent": ["fix-auth"]
},
"phase": "PHASE_RUNNING",
"vm": {"instanceName": "murmur-a1b2c3d4", "project": "acme-agents", "zone": "us-central1-a"},
"version": "0.4+a1b2c3d4",
"progress": {"label": "tool", "detail": "Running tests", "timestamp": "2026-05-14T10:30:00Z"},
"output": {"cost": 0.42}
}
With children
{
"slug": "director",
"children": true
}
With timeline
{
"slug": "fix-auth",
"timeline": ["phase", "taskComplete", "commit"]
}
Absolute slug targeting another agent
{
"slug": "/w/backend/u/bob/api-refactor"
}
Errors
| Code | Meaning | What to do |
|---|
NOT_FOUND | No agent with that slug exists. | Check the slug. Use ls to see running agents. |
UNAUTHENTICATED | Identity token is missing or expired. | Check the agent’s credentials. |
murmur status — equivalent CLI command- Agents — concept overview
spawn — create an agentls — list running agentskill — cancel an agentwait — block until an agent reaches a target phase
