Quickstart

1) Initialize configuration

muthr init
muthr config init
muthr config show

Notes:

• muthr init populates ~/.config/muthr/ from muthr-specs.
• muthr config init creates ~/.config/muthr/muthr.toml if missing.

2) Start engine + services

muthr run

Equivalent explicit flow:

muthr engine start --runtime llama
muthr services start

3) Enter a project sandbox

cd ~/src/myproject
muthr sandbox shell --profile opencode

Inside the sandbox, launch your agent:

opencode                     # opencode profile
hermes-agent                 # hermes-agent profile

For quick commands without a full interactive shell:

muthr sandbox shell --profile opencode --no-tty -c "echo hello"

4) Verify status

muthr
muthr sandbox ls
muthr doctor

5) Shutdown cleanly

muthr shutdown --yes

muthr shuts down managed sandboxes, services containers, and engine runtimes in dependency order.

---

See also: Installation · Commands · Concepts