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.

murmur init is an interactive wizard that turns one or more local repos into a fully provisioned Workspace, including the underlying Recipe, Image bake, and a smoke test.
Run murmur setup first. murmur init reads your tenant config from .murmur/murmur.yaml, which setup creates.

Run murmur init

From inside one of the repos your Workspace will span:
murmur init
The wizard inspects your repo(s), generates a Recipe, bakes the Image, runs a smoke test, and creates or updates the Workspace. The full flow takes 10 to 20 minutes, most of it the unattended bake. You only need to be at the keyboard for the first few minutes. You only need to run init once per Workspace. The wizard will ask you which repos to include, so list every repo your agents need to clone onto the same VM.

What gets customized

The custom part lives in your Recipe, the shell script the wizard generates and bakes into a VM Image. Typical things to install:
  • Language toolchains beyond Node.js (Go, Python, Ruby, Java)
  • Build tools (Docker, Bazel, make)
  • Private CLIs or SDKs
  • System packages your repos need (libpq-dev, ImageMagick, ffmpeg)
  • Environment variables and dotfiles
See Bake a custom agent Image for the full anatomy of a Recipe.

Next steps

Spawn your first agent

Launch an agent into the Workspace you just customized.

Bake a custom agent Image

Edit your Recipe to add tools, libraries, or private dependencies.