murmur status CLI command

Prints the current status of an agent. Shows the agent’s phase, VM assignment, latest progress, queued follow-ups, and output (response, PRs, cost).

Synopsis

murmur status [flags] [slug]

On a VM, the slug is optional. If you omit it, the command queries the current agent’s own status.

Arguments

Name	Type	Required	Description
`slug`	string	on laptop	The agent’s slug, or a slash-separated path to a descendant (e.g. `director/fix-auth`). Use an absolute path like `/w/{workspace}/{owner_provider}/{account}/{slug}` for an agent outside your own path. On a VM, a relative path names a child of the calling agent, and omitting it targets the calling agent itself.
`--service`	bool	no	Query a service-profile agent instead of a developer agent. Requires a slug. It looks the slug up under the `service_profile` provider with your own account name, so it finds an agent only when the service profile’s name matches your account. To reach any other service-profile agent, pass its absolute path, as in the example below. Default: `false`.
`--json`	bool	no	Print the `AgentStatus` as JSON instead of the key-value lines. Default: `false`.
`--workspace`	string	no	Workspace 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.

Field	Description
`workflow`	The agent’s full workflow identifier.
`phase`	Current lifecycle phase (see below).
`dashboard`	The agent’s dashboard URL.
`vm`	VM instance name, project, zone, and state (`running`, `stopped`, or `deleted`).
`version`	The murmur version running on the VM.
`progress`	Latest progress message from the agent.
`working on`	The agent’s current task description.
`queued`	Pending follow-up messages waiting to be processed, one per line as `[follow-up-id] preview`.
`deferred`	Deferred follow-up messages (self-scheduled “resume me at T”), each annotated with its delivery time.
`delivering`	Follow-up messages being delivered to the agent’s current turn.
`response`	The agent’s last response text.
`pr`	Pull request title and URL. Repeated if multiple PRs.
`cost`	Cumulative API cost in USD.

A queue list that is longer than the status payload carries ends with a +N more line.

Phases

Phase	Meaning
`PHASE_BILLING_BLOCKED`	Billing does not currently allow the organization new usage. The agent waits without a VM and starts on its own once billing allows.
`PHASE_STARTING`	Agent is provisioning: acquiring a VM.
`PHASE_RECOVERING_VM`	The agent’s VM stopped and its disk is being brought back: restarted in place, moved to another zone or provisioning model, or replaced by a fresh VM.
`PHASE_PREPARING_WORKSPACE`	Repositories are being cloned or updated and working branches configured. Precedes the agent’s first turn.
`PHASE_RUNNING`	Agent is actively working on a task.
`PHASE_TASK_COMPLETE`	Agent finished a task and is waiting for follow-ups or will go idle.
`PHASE_IDLE`	Agent is idle: VM is still running, waiting for a follow-up or sleep.
`PHASE_SLEEPING`	VM is stopped. The agent wakes on the next follow-up or `murmur wake`.
`PHASE_DESTROYING`	Agent is shutting down and destroying its VM.
`PHASE_COMPLETED`	Agent finished and exited normally. Terminal.
`PHASE_FAILED`	Agent encountered an error. Terminal.
`PHASE_CANCELED`	Agent was killed. Terminal.

Examples

Basic status check

murmur status fix-auth

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

Completed agent with output

murmur status fix-auth

workflow: github_app/acme/w/backend/github_oauth/alice/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)
cost:     $0.85

Status of a child agent

murmur status director/fix-auth

workflow: github_app/acme/w/backend/github_oauth/alice/director/fix-auth
phase:    PHASE_RUNNING
progress: [text] Writing tests for the token refresh path (1m ago)

Service agent status

murmur status /w/backend/service_profile/merge-queue/merge-queue

workflow: github_app/acme/w/backend/service_profile/merge-queue/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

Code	Meaning	What to do
`NOT_FOUND`	No agent with that slug exists.	Check the slug spelling. Use `murmur ls` to see running agents.
`UNAUTHENTICATED`	Identity token is missing or expired.	Run `murmur login` or check your `murmur.local.yaml` configuration.
none	`service status requires a slug`	`--service` was passed without a slug. It cannot default to self. Pass the service agent’s slug.

Agents: concept overview
murmur spawn: start an agent
murmur ls: list running agents
murmur kill: cancel an agent
murmur wait: block until an agent reaches a target phase
murmur sleep: stop an agent’s VM
murmur wake: restart a sleeping agent’s VM

Getting Started

Core Concepts

Guides

murmur status CLI command

Synopsis

Arguments

Output

Phases

Examples

Basic status check

Completed agent with output

Status of a child agent

Service agent status

Self-status on a VM

Errors

​Synopsis

​Arguments

​Output

​Phases

​Examples

​Basic status check

​Completed agent with output

​Status of a child agent

​Service agent status

​Self-status on a VM

​Errors

​Related

Synopsis

Arguments

Output

Phases

Examples

Basic status check

Completed agent with output

Status of a child agent

Service agent status

Self-status on a VM

Errors

Related