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

> Read a catalog resource by kind and name, or list every resource of a kind across the tenant, with output as YAML, JSON, or a summary table.

Reads a single [catalog](/catalog/overview) resource and prints it as YAML. When the name is omitted, lists all resource names of the given kind.

## Synopsis

```bash theme={null}
murmur get <kind> [name]
```

## Arguments

| Name   | Type   | Required | Description                                                                                                                                                    |
| ------ | ------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `kind` | string | yes      | The [catalog](/catalog/overview) resource kind (e.g. `workspace`, `environment`, `placement`). Run [`murmur describe`](/cli/describe) to list available kinds. |
| `name` | string | no       | The resource name. When omitted, lists all resources of the kind.                                                                                              |

## Output

### Single resource

When a name is provided, the command prints the resource as YAML to stdout.

### List mode

When the name is omitted, the command prints one resource name per line. For `agent-persona` resources, the output includes a `[platform]` marker for built-in [personas](/concepts/agent-personas) and a description column.

## Examples

### Get a single workspace

```bash theme={null}
murmur get workspace default
```

```yaml theme={null}
name: default
image_ref: murmur-base-a1b2c3d4e5f67890
environment_ref: default
placement: murmur-gcp-us-central1
repos:
  - clone_url: https://github.com/acme/backend
```

### List all environments

```bash theme={null}
murmur get environment
```

```
default
gpu
ml-large
```

### List agent personas

```bash theme={null}
murmur get agent-persona
```

```
programmer              Default coding agent
architect   [platform]  Plans multi-agent work and delegates to specialists
reviewer    [platform]  Reviews pull requests for correctness and style
```

### Pipe a resource into another command

```bash theme={null}
murmur get environment staging | yq '.machine_type_ref'
```

```
murmur-n2-standard-16
```

## Errors

| Code               | Meaning                                     | What to do                                                                                   |
| ------------------ | ------------------------------------------- | -------------------------------------------------------------------------------------------- |
| `NOT_FOUND`        | No resource with that kind and name exists. | Check the name spelling. Run `murmur get <kind>` without a name to list available resources. |
| `UNAUTHENTICATED`  | Identity token is missing or expired.       | Run `murmur auth` or check your `murmur.local.yaml` configuration.                           |
| `INVALID_ARGUMENT` | The kind is not recognized.                 | Run [`murmur describe`](/cli/describe) to list valid kinds.                                  |

## Related

* [Catalog](/catalog/overview) -- concept overview
* [`murmur set`](/cli/set) -- create or replace a resource
* [`murmur patch`](/cli/patch) -- update individual fields on a resource
* [`murmur rm`](/cli/rm) -- delete a resource
* [`murmur describe`](/cli/describe) -- show schema information for a kind