> ## Documentation Index
> Fetch the complete documentation index at: https://docs.murmur.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# murmur pool status

> Show the current state of your tenant's VM pool — warm VMs ready for assignment, in-flight bakes, and pool-config capacity limits.

Prints the current state of your tenant's [pool](/concepts/pools). Shows how many warm VMs are available and lists each one by name and task queue.

## Synopsis

```bash theme={null}
murmur pool status [flags]
```

<Note>
  [Pool](/concepts/pools) commands run from your laptop only. They are not available on agent VMs.
</Note>

## Arguments

| Name          | Type   | Required | Description                                             |
| ------------- | ------ | -------- | ------------------------------------------------------- |
| `--workspace` | string | no       | Workspace name. Overrides the value from `murmur.yaml`. |

## Output

The output starts with a `warm:` count line, followed by one indented line per warm VM.

| Field       | Description                                              |
| ----------- | -------------------------------------------------------- |
| `warm`      | Total number of warm VMs in the [pool](/concepts/pools). |
| Per-VM line | The VM's instance name and task queue.                   |

## Examples

### Pool with warm VMs

```bash theme={null}
murmur pool status
```

```
warm: 3
  warm: murmur-a1b2c3d4 (murmur-a1b2c3d4)
  warm: murmur-e5f6g7h8 (murmur-e5f6g7h8)
  warm: murmur-i9j0k1l2 (murmur-i9j0k1l2)
```

Three VMs are pre-booted and ready. The next [`murmur spawn`](/cli/spawn) claims one instantly.

### Empty pool

```bash theme={null}
murmur pool status
```

```
warm: 0
```

No warm VMs are available. The next [`murmur spawn`](/cli/spawn) triggers a cold boot, which takes longer. Use [`murmur pool up`](/cli/pool-up) to ensure the [pool](/concepts/pools) is running and backfilling.

## Errors

| Code                | Meaning                                                | What to do                                                         |
| ------------------- | ------------------------------------------------------ | ------------------------------------------------------------------ |
| `UNAUTHENTICATED`   | Identity token is missing or expired.                  | Run `murmur auth` or check your `murmur.local.yaml` configuration. |
| `PERMISSION_DENIED` | Your role does not have `pool-config.read` permission. | Ask a tenant admin to grant you the required permission.           |
| (exit error)        | `pool commands are not supported on VMs`               | Run this command from your laptop, not from an agent VM.           |

## Related

* [Pools](/concepts/pools) — concept overview
* [`pool-config`](/catalog/pool-config) — catalog resource that controls pool capacity limits
* [`murmur pool up`](/cli/pool-up) — ensure the pool is running
* [`murmur pool flush`](/cli/pool-flush) — destroy warm VMs so the pool replenishes
* [`murmur spawn`](/cli/spawn) — start an agent (claims a warm VM from the pool)
* [`murmur ls`](/cli/ls) — list running agents