Commands

Top-level

• muthr engine
• muthr sandbox
• muthr services
• muthr run
• muthr shutdown
• muthr completion
• muthr init
• muthr config
• muthr doctor
• muthr image

Running muthr with no subcommand shows current engine/services/sandbox status.

Engine

Start

muthr engine start [--runtime mlxcel|llama|vllm-mlx] [--profile MODEL_OR_PRESET] [--bind-host HOST] [--engine-server-port PORT] [--foreground]

Key flags:

• --runtime choose runtime (mlxcel, llama, or vllm-mlx)
• --profile model repo/path or preset name
• --bind-host server bind address (127.0.0.1 or 0.0.0.0)
• --engine-server-port override API port
• --foreground keep process attached to terminal

Stop

muthr engine stop [--runtime mlxcel|llama|vllm-mlx] [--all]

Status / presets

muthr engine status --output text|json|ndjson
muthr engine presets [--runtime mlxcel|llama|vllm-mlx] --output text|json|ndjson

Sandbox

Start

muthr sandbox start [--profile PROFILE] [--audit-log PATH]

Shell

muthr sandbox shell [--profile PROFILE] [-c|--command CMD] [--no-tty] [-e|--env KEY=VALUE] [--audit-log PATH]

Stop

muthr sandbox stop [--all] [--name SANDBOX ...]

--all and --name are mutually exclusive.

Delete

muthr sandbox delete [--force] [--yes] [--dry-run]

Delete is context-based: it targets the sandbox for the current project directory.

List

muthr sandbox ls --output text|json|ndjson [--quiet]

Services

muthr services start [--dry-run]
muthr services stop [--dry-run]
muthr services restart [--dry-run]
muthr services delete [--force|--yes] [--dry-run]
muthr services status --output text|json|ndjson

Run / shutdown

muthr run [--profile MODEL] [--runtime mlxcel|llama|vllm-mlx] [--dry-run]
muthr shutdown [--timeout SECONDS] [--yes] [--dry-run]

Global flags

--quiet (-q) and --verbose (-v) are available on all commands:

• -q suppresses non-error informational output
• -v shows detailed operational logs

Config / init / doctor / image

muthr init [--git-url URL] [--force]
muthr config init [--force]
muthr config show
muthr doctor
muthr image build --profile PROFILE

Output contract

When available, output mode is explicit:

• text: human-oriented status on stderr
• json: structured payload on stdout
• ndjson: one JSON object per line on stdout

This keeps shell scripts stable while preserving readable terminal UX.

---

See also: Quickstart · Configuration · Profiles