murmur get

Reads a single catalog resource and prints it in the same format murmur set consumes: raw markdown (frontmatter + body) for markdown-input kinds (agent-persona, flight), YAML for everything else. When the name is omitted, lists all resource names of the given kind.

Synopsis

murmur get <kind> [name]

Arguments

Name	Type	Required	Description
`kind`	string	yes	The catalog resource kind (e.g. `workspace`, `environment`, `placement`). Run `murmur 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 to stdout in the format murmur set accepts for the kind: markdown-input kinds (agent-persona, flight) print the resource’s rendered markdown (YAML frontmatter + prompt body) verbatim; all other kinds print YAML. Run murmur describe to see each kind’s input format.

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 and a description column.

Examples

Get a single workspace

murmur get workspace default

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

murmur get environment

default
gpu
ml-large

List agent personas

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

murmur get environment staging | yq '.machine_type_ref'

murmur-n2-standard-16

Edit an agent persona in place

Markdown kinds round-trip through get and set with no conversion:

murmur get agent-persona programmer > programmer.md
# edit programmer.md
murmur set agent-persona programmer < programmer.md

---
description: Default coding agent
model: claude-opus-4-8
---
You write museum-quality Go.

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` to list valid kinds.

Catalog — concept overview
murmur set — create or replace a resource
murmur patch — update individual fields on a resource
murmur rm — delete a resource
murmur describe — show schema information for a kind

Getting Started

Core Concepts

Guides

Synopsis

Arguments

Output

Single resource

List mode

Examples

Get a single workspace

List all environments

List agent personas

Pipe a resource into another command

Edit an agent persona in place

Errors

​Synopsis

​Arguments

​Output

​Single resource

​List mode

​Examples

​Get a single workspace

​List all environments

​List agent personas

​Pipe a resource into another command

​Edit an agent persona in place

​Errors

​Related

Synopsis

Arguments

Output

Single resource

List mode

Examples

Get a single workspace

List all environments

List agent personas

Pipe a resource into another command

Edit an agent persona in place

Errors

Related