status - Murmur

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

{
  "slug": "fix-auth"
}

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 agent
ls — list running agents
kill — cancel an agent
wait — block until an agent reaches a target phase

​Parameters

​Timeline event types

​Response

​Examples

​Basic status check

​With children

​With timeline

​Absolute slug targeting another agent

​Errors

​Related