Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
MCP tool that queries an agent’s current state: lifecycle phase, queued follow-ups, task checklist, pull requests, and cost.
timeline tool.
Equivalent to murmur status in the CLI.
| Name | Type | Required | Description |
|---|---|---|---|
slug | string | yes | Agent task slug (e.g. fix-bug). Use an absolute path like /w/{workspace}/{owner_provider}/{account}/{slug} (e.g. /w/backend/github_oauth/alice/fix-auth) to target an agent outside your own path. |
workspace | string | no | Workspace name. Overrides the session default. Required only when nothing else supplies one: off a VM, with no session default, and with a slug that is not a /w/{workspace}/... path. |
| Field | Type | Description |
|---|---|---|
agentId | object | The agent’s identity: tenant, ownerProvider, account, workspace, and the agent slug path. |
phase | string | Current lifecycle phase (e.g. PHASE_RUNNING, PHASE_TASK_COMPLETE). See murmur status for the full list. |
agent | string | The agent persona (e.g. programmer). |
description | string | The description this agent’s current run started with. |
currentDescription | string | The task description the current turn is working on. |
dashboardUrl | string | The agent’s dashboard URL. |
vmStopped | boolean | true when the VM is stopped (sleeping). |
vmDeleted | boolean | true when the VM and its disk no longer exist. Takes precedence over vmStopped. |
version | string | The murmur version running on the VM. |
progressAt | string | When the agent last reported progress (RFC 3339). |
sessionMode | string | SESSION_MODE_AUTONOMOUS when each turn runs to completion, or SESSION_MODE_STREAMING for a long-lived session that follow-ups stream into. |
model | string | The model override, if any. |
backend | string | claude or codex. |
tasks | object[] | The agent’s current task checklist. |
queue | object | Every undelivered follow-up, in delivery order: queued, deferred, and delivering lists, each with a matching *Total count. Each entry carries a followUpId and a preview. |
queuedFollowUps | string[] | Previews of follow-ups waiting on the current turn. |
delayedFollowUps | string[] | Previews of deferred follow-ups, each annotated with its delivery time. |
output | object | Agent output: response text, prs array, cost in USD, and token counts. |
failure | object | Structured failure details when the agent reached PHASE_FAILED. |
tags | string[] | Names of the tags attached to the agent. |
idleTimeout | string | How long the agent waits idle before its on_idle policy fires, as a Go duration. |
sleepTimeout | string | How long the agent’s VM may stay asleep before the agent ends, as a Go duration. Empty means it sleeps indefinitely. |
{
"slug": "fix-auth"
}
{
"agentId": {
"tenant": {"provider": "PROVIDER_GITHUB_APP", "org": "acme"},
"ownerProvider": "PROVIDER_GITHUB_OAUTH",
"account": "alice",
"workspace": "backend",
"agent": ["fix-auth"]
},
"phase": "PHASE_RUNNING",
"agent": "programmer",
"version": "0.4+a1b2c3d4",
"progressAt": "2026-05-14T10:30:00Z",
"sessionMode": "SESSION_MODE_STREAMING",
"backend": "claude",
"dashboardUrl": "https://murmur.example.com/github_app/acme/task/github_app%2Facme%2Fw%2Fbackend%2Fgithub_oauth%2Falice%2Ffix-auth",
"output": {"cost": 0.42}
}
{
"slug": "/w/backend/github_oauth/bob/api-refactor"
}
| 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. |