Skip to main content

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.

An environment defines how big your agent VMs are — the machine type (vCPUs, memory) and disk size. Each workspace references one environment via its environment_ref field. Environments are cloud-aware but location-independent. An environment targets a substrate (GCP or AWS), which determines what machine types are valid. But it does not specify where to run — that’s the placement’s job. You can reuse the same environment across any placement of the same substrate.

Machine types

Machine types are platform-provided resources that name a specific VM size — vCPUs, memory, architecture, and optional GPU. Environments reference them by name. List available machine types with murmur get machine-type. You do not create machine types — they are builtins. You pick one when defining an environment.

Creating an environment

Create environments with murmur set environment. Each environment specifies a substrate, machine type reference, disk type reference, and optional disk size. Then reference it from a workspace via the environment_ref field. See the environment reference for all fields.
TypePage
Referenceenvironment
Referencemachine-type
Referencedisk-type
GuideVM environment
ConceptPlacements
ConceptWorkspaces