murmur ls

Lists top-level agents. By default, shows only your own active (non-terminal) agents. Use flags to include completed agents, other developers’ agents, or to get machine-readable output. On a VM, murmur ls lists the direct children of the current agent. It does not include the current agent itself or agents outside its subtree. Account and workspace selectors only narrow results. Discovery requires agent.read from tenant, runtime, or workspace grants, plus applicable workspace access. Grants on individual agents authorize direct access but not discovery. An authorized listing with no matching entries succeeds with an empty result; see listing rules.

Synopsis

murmur ls [flags]

Arguments

Name	Type	Required	Description
`-a`	bool	no	Also include terminal (completed, failed, canceled) agents. Widens the phase filter only: it does not change which developers are listed (use `-A` or `-developer`). Default: `false`.
`-q`	bool	no	Print only slugs, one per line. Default: `false`.
`-json`	bool	no	Output as a JSON array. Default: `false`.
`-A`	bool	no	List every developer’s agents instead of only your own. Default: `false`.
`-developer`	string	no	List a specific account’s agents. A bare name resolves under your own provider. Qualify it to cross providers (e.g. `service_profile/deploy`).
`-workspace`	string	no	Workspace name. Overrides the value from `murmur.yaml`.

Output

The default output is a tab-aligned table with six columns:

Column	Description
`SLUG`	The agent’s path. A child agent is displayed as `parent/child`.
`PHASE`	Current lifecycle phase: `billing-blocked`, `starting`, `recovering-vm`, `preparing-workspace`, `running`, `task-complete`, `idle`, `sleeping`, `destroying`, `completed`, `failed`, or `canceled`. An agent whose sleep timeout ended shows `(expired)` after its phase and stays listed until it is deleted.
`VM`	VM instance name. Empty if no VM is assigned.
`PROGRESS`	Latest progress event, formatted as `[label] detail (time ago)`. Labels include `text`, `tool`, `pr`, `commit`, and `push`.
`COST`	Cumulative API cost in USD (e.g. `$1.23`). Empty if zero.
`DASHBOARD`	The agent’s dashboard URL.

When no agents match, the command prints no table, writes a no agents note to stderr (with a hint to use -a when it is not set), and exits successfully.

Quiet mode (`-q`)

Prints one slug per line with no header. Useful for scripting: pipe to xargs or loop over the result.

JSON mode (`-json`)

Prints a JSON array of objects. Each object has slug, phase, vm, progress, progress_at, and cost fields, plus dashboard_url and sleep_expired when set. phase is the kebab-case label shown in the table, without the (expired) marker. An empty result produces [], not null.

Examples

List active agents

murmur ls

SLUG         PHASE     VM               PROGRESS                                           COST   DASHBOARD
fix-auth     running   murmur-a1b2c3d4  [text] Investigating auth middleware (2m ago)      $0.42  https://cloud.murmur.dev/github_app/acme/task/github_app%2Facme%2Fw%2Fbackend%2Fgithub_oauth%2Falice%2Ffix-auth
add-tests    starting                                                                             https://cloud.murmur.dev/github_app/acme/task/github_app%2Facme%2Fw%2Fbackend%2Fgithub_oauth%2Falice%2Fadd-tests
refactor-db  idle      murmur-e5f6g7h8  [pr] https://github.com/acme/api/pull/87 (1h ago)  $1.05  https://cloud.murmur.dev/github_app/acme/task/github_app%2Facme%2Fw%2Fbackend%2Fgithub_oauth%2Falice%2Frefactor-db

Include completed agents

murmur ls -a

SLUG         PHASE      VM               PROGRESS                                           COST   DASHBOARD
fix-auth     running    murmur-a1b2c3d4  [text] Investigating auth middleware (2m ago)      $0.42  https://cloud.murmur.dev/github_app/acme/task/github_app%2Facme%2Fw%2Fbackend%2Fgithub_oauth%2Falice%2Ffix-auth
add-tests    starting                                                                              https://cloud.murmur.dev/github_app/acme/task/github_app%2Facme%2Fw%2Fbackend%2Fgithub_oauth%2Falice%2Fadd-tests
refactor-db  completed                   [pr] https://github.com/acme/api/pull/87 (3h ago)  $1.05  https://cloud.murmur.dev/github_app/acme/task/github_app%2Facme%2Fw%2Fbackend%2Fgithub_oauth%2Falice%2Frefactor-db
old-cleanup  canceled                                                                       $0.10  https://cloud.murmur.dev/github_app/acme/task/github_app%2Facme%2Fw%2Fbackend%2Fgithub_oauth%2Falice%2Fold-cleanup

List all developers’ agents

murmur ls -A

SLUG       PHASE    VM               PROGRESS                                       COST   DASHBOARD
fix-auth   running  murmur-a1b2c3d4  [text] Investigating auth middleware (2m ago)  $0.42  https://cloud.murmur.dev/github_app/acme/task/github_app%2Facme%2Fw%2Fbackend%2Fgithub_oauth%2Falice%2Ffix-auth
add-tests  running  murmur-f9g0h1i2  [tool] Bash, Read (30s ago)                    $0.88  https://cloud.murmur.dev/github_app/acme/task/github_app%2Facme%2Fw%2Fbackend%2Fgithub_oauth%2Fbob%2Fadd-tests

The SLUG column does not name the owning developer.

List a specific developer’s agents

murmur ls -developer alice

Slugs only for scripting

murmur ls -q

fix-auth
add-tests
refactor-db

Use this to kill all active agents:

murmur ls -q | xargs -I{} murmur kill {}

JSON output

murmur ls -json

[
  {
    "slug": "fix-auth",
    "phase": "running",
    "vm": "murmur-a1b2c3d4",
    "progress": {
      "run_id": 1,
      "Event": {
        "AssistantText": {
          "message": "Investigating auth middleware"
        }
      }
    },
    "progress_at": "2026-05-14T10:30:00Z",
    "cost": 0.42,
    "dashboard_url": "https://cloud.murmur.dev/github_app/acme/task/github_app%2Facme%2Fw%2Fbackend%2Fgithub_oauth%2Falice%2Ffix-auth"
  }
]

Child agents on a VM

When running on an agent VM, murmur ls lists child agents spawned by the current agent:

murmur ls

SLUG                PHASE     VM               PROGRESS                     COST   DASHBOARD
director/fix-auth   running   murmur-a1b2c3d4  [tool] Bash, Edit (15s ago)  $0.30  https://cloud.murmur.dev/github_app/acme/task/github_app%2Facme%2Fw%2Fbackend%2Fgithub_oauth%2Falice%2Fdirector%2Ffix-auth
director/add-tests  sleeping                   [push] main (5m ago)         $0.65  https://cloud.murmur.dev/github_app/acme/task/github_app%2Facme%2Fw%2Fbackend%2Fgithub_oauth%2Falice%2Fdirector%2Fadd-tests

Errors

Code	Meaning	What to do
`UNAUTHENTICATED`	Identity token is missing or expired.	Run `murmur login` or check your `murmur.local.yaml` configuration.
`INVALID_ARGUMENT`	`account selector "<value>": ...`: a provider-qualified `-developer` value names an unknown provider or is malformed.	Use a bare account name, or `<provider>/<account>` (e.g. `service_profile/deploy`).

Agents: concept overview
murmur status: detailed status for a single agent
murmur kill: cancel an agent
murmur spawn: start an agent

Getting Started

Core Concepts

Guides

Synopsis

Arguments

Output

Quiet mode (`-q`)

JSON mode (`-json`)

Examples

List active agents

Include completed agents

List all developers’ agents

List a specific developer’s agents

Slugs only for scripting

JSON output

Child agents on a VM

Errors

​Synopsis

​Arguments

​Output

​Quiet mode (-q)

​JSON mode (-json)

​Examples

​List active agents

​Include completed agents

​List all developers’ agents

​List a specific developer’s agents

​Slugs only for scripting

​JSON output

​Child agents on a VM

​Errors

​Related

Synopsis

Arguments

Output

Quiet mode (`-q`)

JSON mode (`-json`)

Examples

List active agents

Include completed agents

List all developers’ agents

List a specific developer’s agents

Slugs only for scripting

JSON output

Child agents on a VM

Errors

Related