Config

Configuration controls models, sandbox, memory, MCP, extensions, and TUI behavior. Veyyon loads layered YAML/JSON from the project and user agent directories.

Responsibility

• Resolve config roots (.veyyon, plus Claude/Codex/Gemini compatibility paths)
• Merge project + user settings; apply profiles (veyyon --profile <name>)
• Validate against settings-schema.ts; support CLI -c key=value overrides
• Feed resolved settings to sessions, tools, and discovery (skills, hooks, MCP, extensions)

Public boundary

• Primary user file: ~/.veyyon/agent/config.yml (or profile path under ~/.veyyon/profiles/)
• Project overrides: .veyyon/config.yml
• CLI: veyyon config list|get|set, /settings, /reload (re-read without restart)

Config loading is part of the harness.

Everyday guide: Configuration.

Engineering detail: docs/config-usage.md, docs/settings.md.