Configuration

minnal reads configuration from ~/.minnal/config.toml with optional overrides per-repo at .minnal/config.toml.

Config file

toml

[ui]
alignment = "left"   # "left" or "centered" — also Alt+C in TUI
theme     = "auto"   # "auto", "light", "dark"

[memory]
embeddings_local = true
extract_every    = 12      # turns between extractions
consolidate      = "ambient"

[server]
listen = "127.0.0.1:7173"  # used by `minnal serve`

[providers.anthropic]
auth = "oauth"             # or "api_key"

[providers.openai_compatible.local-vllm]
base_url = "http://localhost:8000/v1"
model    = "qwen2.5-coder-32b"
api_key  = ""              # leave empty for unauthenticated local servers

Environment variables

MINNAL_HOME — overrides the data dir (default ~/.minnal).
MINNAL_LOG — log level (error, warn, info, debug, trace).
MINNAL_NO_TELEMETRY=1 — disable opt-in telemetry.
ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY, … — fall-through API keys for providers.

Logs and debug socket

Daily log files are written to ~/.minnal/logs/minnal-YYYY-MM-DD.log. For runtime debugging, attach to the debug socket exposed by minnal serve.

AGENTS.md

Project conventions live in an AGENTS.md at the repo root. Run /init in a fresh project to generate one. minnal automatically loads it (and any nested AGENTS.mdin subdirectories) into the agent's system prompt.