Config Patterns

Install Options

# Release installer
curl -fsSL -o /tmp/install-mistermorph.sh https://raw.githubusercontent.com/quailyquaily/mistermorph/refs/heads/master/scripts/install-release.sh
sudo bash /tmp/install-mistermorph.sh

# Go install
go install github.com/quailyquaily/mistermorph/cmd/mistermorph@latest

Initialize Files

mistermorph install

By default, state is stored under ~/.morph/ and cache under ~/.cache/morph.

For the difference between workspace_dir, file_cache_dir, and file_state_dir, see Filesystem Roots.

Config Sources (precedence)

• CLI flags
• Environment variables
• config.yaml

Minimal config.yaml

llm:
  inference_provider: openai
  model: gpt-5.4
  api_key: ${OPENAI_API_KEY}

LLM Profiles and Routes

llm:
  model: gpt-5.4
  profiles:
    cheap:
      model: gpt-4.1-mini
    reasoning:
      inference_provider: xai
      model: grok-4.1-fast-reasoning
  routes:
    main_loop:
      candidates:
        - profile: default
          weight: 1
        - profile: cheap
          weight: 1
      fallback_profiles: [reasoning]
    addressing:
      profile: cheap
    awareness: cheap
    think: reasoning

Tool Toggles

tools:
  bash:
    enabled: false
  url_fetch:
    enabled: true
    timeout: "30s"

Runtime Limits

max_steps: 20
tool_repeat_limit: 4

Use assets/config/config.example.yaml as canonical key list.