Skip to main content
Prints the current status of an agent. Shows the agent’s phase, VM assignment, latest progress, output (PRs, commits, cost), and optionally its children and lifecycle timeline.

​
Synopsis

murmur status [flags] [slug]
On a VM, the slug is optional — omitting it queries the current agent’s own status.

​
Arguments

NameTypeRequiredDescription
slugstringon laptopThe agent’s slug. Optional on VMs (defaults to self).
--serviceboolnoQuery a service agent instead of a developer agent. Default: false.
--childrenboolnoInclude child agent statuses in the output. Default: false.
--timelineboolnoInclude the lifecycle timeline in the output. Default: false.
--workspacestringnoWorkspace name. Overrides the value from murmur.yaml.

​
Output

The output is a set of key-value lines. Fields appear only when they have a value.
FieldDescription
workflowThe agent’s full workflow identifier.
phaseCurrent lifecycle phase (see below).
vmVM instance name, project, zone, and state (running or stopped).
versionThe murmur version running on the VM.
progressLatest progress message from the agent.
modeinteractive when the agent is in interactive mode.
working onThe agent’s current task description.
queuedPending follow-up messages waiting to be processed.
responseThe agent’s last response text.
prPull request title and URL. Repeated if multiple PRs.
commitsNumber of commits the agent has made.
costCumulative API cost in USD.
childrenChild agent statuses (only with --children).

​
Phases

PhaseMeaning
PHASE_STARTINGAgent is provisioning — acquiring a VM and preparing the workspace.
PHASE_RUNNINGAgent is actively working on a task.
PHASE_TASK_COMPLETEAgent finished a task and is waiting for follow-ups or will go idle.
PHASE_IDLEAgent is idle — VM is still running, waiting for a follow-up or sleep.
PHASE_SLEEPINGVM is stopped. The agent wakes on the next follow-up or murmur wake.
PHASE_CHECKS_PENDINGAgent is waiting for CI checks to complete on a PR.
PHASE_DESTROYINGAgent is shutting down and releasing its VM.
PHASE_COMPLETEDAgent finished and exited normally. Terminal.
PHASE_FAILEDAgent encountered an error. Terminal.
PHASE_CANCELEDAgent was killed. Terminal.

​
Examples

​
Basic status check

murmur status fix-auth

workflow: github_oauth/alice/w/backend/fix-auth
phase:    PHASE_RUNNING
vm:       murmur-a1b2c3d4 (acme-agents/us-central1-a) [running]
version:  0.4+a1b2c3d4
progress: Investigating auth middleware (2m ago)

​
Completed agent with output

murmur status fix-auth

workflow: github_oauth/alice/w/backend/fix-auth
phase:    PHASE_COMPLETED
response: Fixed the auth middleware to validate JWT expiry before checking claims.
pr:       Fix JWT expiry validation (https://github.com/acme/backend/pull/42)
commits:  3
cost:     $0.85

​
Status with children

murmur status director --children

workflow: github_oauth/alice/w/backend/director
phase:    PHASE_RUNNING
progress: Coordinating child agents
children:
  fix-auth (github_oauth/alice/w/backend/director/fix-auth): CHILD_STATUS_COMPLETED
  add-tests (github_oauth/alice/w/backend/director/add-tests): CHILD_STATUS_RUNNING

​
Service agent status

murmur status merge-queue --service

workflow: github_app/acme/w/backend/s/murmuration/merge-queue
phase:    PHASE_SLEEPING

​
Self-status on a VM

When running on an agent VM, omit the slug to query the current agent: 
murmur status

​
Errors

CodeMeaningWhat to do
NOT_FOUNDNo agent with that slug exists.Check the slug spelling. Use murmur ls to see running agents.
UNAUTHENTICATEDIdentity token is missing or expired.Run murmur auth or check your murmur.local.yaml configuration.
INVALID_ARGUMENTservice status requires a slugThe --service flag requires a slug — it cannot default to self.