> ## 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 resource

> List the murmur-owned VMs, disks and snapshots, or images in one placement.

Lists cloud resources that Murmur owns in a [placement](/concepts/placement), limited to your tenant. There are three subcommands:

| Subcommand | Lists |
| - | - |
| `vms <placement>` | Murmur-owned VMs. |
| `disks <placement>` | Murmur-owned persistent disks and snapshots. |
| `images <placement>` | Murmur-provisioned images. |

## Synopsis

```bash theme={null}
murmur resource vms [flags] <placement>
murmur resource disks [flags] <placement>
murmur resource images [flags] <placement>
```

## Arguments

| Name | Type | Required | Description |
| - | - | - | - |
| `placement` | string | yes | The placement to list, by name. |
| `--json` | bool | no | Print a JSON array instead of the table. Default: `false`. |
| `--full-hash` | bool | no | `images` only. Show the full image hash instead of the first 12 characters. Default: `false`. |
| `--workspace` | string | no | Workspace name. Overrides the value from `murmur.yaml`. |

Listing requires `placement.read`. An empty placement prints nothing.

## `murmur resource vms`

```bash theme={null}
murmur resource vms acme-agents
```

```
NAME             STATE    MACHINE TYPE   CAPACITY   $/HR   ENV      USER   OWNER        CREATED
murmur-a1b2c3d4  running  e2-standard-8  spot       $0.08  default  alice  fix-auth     2026-09-27T14:01:55Z
murmur-e5f6a7b8  stopped  e2-standard-8  on-demand  --     default  bob    bump-deps    2026-09-26T09:12:40Z
murmur-c9d0e1f2  running  e2-standard-8  spot       $0.08  default  --     pool (warm)  2026-09-27T13:30:02Z
```

| Column | Meaning |
| - | - |
| `STATE` | `running`, `stopped`, `hibernated`, or `unknown`. |
| `CAPACITY` | `spot` or `on-demand`: the capacity pool the VM came from, which is also the rate `$/HR` is priced at. `--` when unknown. |
| `$/HR` | Estimated hourly compute cost. `--` when there is none. |
| `ENV` | The VM's [environment](/concepts/environments). |
| `USER` | The account of the agent that owns the VM, or `--`. |
| `OWNER` | The last segment of the owning agent's slug. A VM Murmur runs for its own work shows its role instead (for example `bake`). Idle warm-pool capacity shows `pool (warm)`. |

With `--json`, each VM is an object with `name`, `state`, `machine_type`, `capacity`, `cost_per_hour`, `storage_cost_per_hour`, `environment`, `user`, `owner`, and `created_at`.

## `murmur resource disks`

```bash theme={null}
murmur resource disks acme-agents
```

```
NAME                                           KIND      TYPE         SIZE   ATTACHED TO      CREATED
murmur-a1b2c3d4                                disk      pd-balanced  100GB  murmur-a1b2c3d4  2026-09-27T14:01:55Z
murmur-9f8e7d6c                                disk      pd-balanced  100GB  orphaned         2026-09-20T11:05:10Z
murmur-5b4a3c2d1e0f9a8b-3f9a1c2b7d4e5f60-snap  snapshot  -            50GB   -                2026-09-25T08:00:00Z
```

`KIND` is `disk` or `snapshot`. `ATTACHED TO` is the VM a disk is attached to, `orphaned` for an unattached disk, or `-` for a snapshot. With `--json`, each entry has `name`, `kind`, `disk_type`, `size_gb`, `attached_to`, and `created_at`.

## `murmur resource images`

```bash theme={null}
murmur resource images acme-agents
```

```
NAME                                      HASH          RECIPE   SIZE  CREATED
murmur-5b4a3c2d1e0f9a8b-3f9a1c2b7d4e5f60  3f9a1c2b7d4e  default  50GB  2026-09-24T17:22:31Z
```

With `--json`, each image has `name`, `hash` (always the full hash), `recipe`, `size_gb`, and `created_at`.

## Errors

| Code | Meaning | What to do |
| - | - | - |
| none | `unknown resource subcommand "<name>"` | Use `vms`, `disks`, or `images`. |
| `NOT_FOUND` | `placement "<name>" not found` | Check the name with [`murmur get placement`](/cli/get). |
| `UNIMPLEMENTED` | `resource listing not implemented for substrate <substrate>` | The placement's substrate does not support resource listing. |
| `PERMISSION_DENIED` | You lack `placement.read`. | Ask for a role that grants `placement.read`. See [authorization](/security/authorization). |
| `UNAUTHENTICATED` | Identity token is missing or expired. | Run [`murmur login`](/cli/login). |

## Related

* [Placement](/concepts/placement): concept overview
* [`placement`](/catalog/placement): catalog resource reference
* [`murmur pool status`](/cli/pool-status): list warm VMs
* [`murmur bakes ls`](/cli/bakes-ls): list image bakes