ls - Murmur

Lists agent tasks. Returns the slug, phase, VM assignment, progress, and cost for each task. By default shows only live tasks for the calling account. From a VM, it lists only the calling agent’s children. Two independent scopes control the result: developer selects which accounts are listed, and include_terminal selects which phases are listed. include_terminal never widens the set of accounts. To see other developers’ agents, set developer. Equivalent to murmur ls in the CLI. Discovery follows the agent listing rules. Selectors confer no authority, and an empty authorized result succeeds. Grants on individual agents permit direct access, not discovery.

Parameters

Name	Type	Required	Description
`include_terminal`	boolean	no	Also include agents in terminal states (completed, failed, canceled). Widens the phase filter only: it does not change which accounts are listed (use `developer` for that). Default: `false` (live agents only).
`developer`	string	no	Which accounts to list: the only way to widen account scope. `""` (default) lists only the calling account’s agents. `*` lists every account in the workspace. `alice` lists one specific account under your own provider. `service_profile/deploy` lists an account under an explicit owner provider, which is the only way to cross providers.
`workspace`	string	no	Workspace name. Overrides the session default.

Response

Returns a JSON array of agent summary objects.

Field	Type	Description
`slug`	string	Agent task slug.
`phase`	string	Current lifecycle phase (e.g. `running`, `task-complete`, `sleeping`).
`vm`	string	VM instance name. Empty when no VM is assigned.
`progress`	object	Latest progress signal: `run_id` and an `Event` object holding one event variant, such as `AssistantText`. Omitted when the agent has reported none.
`progress_at`	string	When the latest progress signal was reported (RFC 3339).
`cost`	number	Cumulative cost in USD.
`dashboard_url`	string	The agent’s dashboard URL. Omitted when unavailable.
`sleep_expired`	boolean	`true` when the agent’s sleep timeout ended it. The agent stays listed until it is deleted. Omitted otherwise.

From a VM, the listing covers only the calling agent’s own children. It never includes the calling agent itself. When that listing is empty, the tool returns a short note explaining this instead of []. Off a VM, an empty result is [].

Examples

List active agents

{}

Response:

[
  {
    "slug": "fix-auth",
    "phase": "running",
    "vm": "murmur-a1b2c3d4",
    "progress": {
      "run_id": 1,
      "Event": {
        "AssistantText": {
          "message": "Running tests"
        }
      }
    },
    "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"
  }
]

Include completed agents

{
  "include_terminal": true
}

All developers in a workspace

{
  "developer": "*",
  "workspace": "backend"
}

Errors

Code	Meaning	What to do
`UNAUTHENTICATED`	Identity token is missing or expired.	Check credentials.

murmur ls: equivalent CLI command
status: detailed status for a single agent
spawn: create an agent
kill: cancel an agent

Getting Started

Core Concepts

Guides

ls

Parameters

Response

Examples

List active agents

Include completed agents

All developers in a workspace

Errors

​Parameters

​Response

​Examples

​List active agents

​Include completed agents

​All developers in a workspace

​Errors

​Related

Parameters

Response

Examples

List active agents

Include completed agents

All developers in a workspace

Errors

Related