Configuration

Configuration

One file: ~/.openphoenix/config.toml. First flight writes it; edit any time. Everything below is optional except the provider.

[provider]
kind = "anthropic"                 # anthropic|openai|openrouter|google|nvidia|groq|mistral|deepseek|ollama
model = "claude-sonnet-5"
fallbacks = ["openrouter/deepseek/deepseek-chat"]
# api_key via env var; [provider.keys] holds per-provider key rings

[agent]
sessions = true                    # remember chats between restarts
thinking = "off"                   # off|low|medium|high
stream = false
# lean = "off"                     # off|lean|grunt

[security]
workspace = "~/phoenix-work"
approvals = true                   # shell commands wait for /approve

[telegram]
token = "…"
allowed_chat_ids = ["111111111"]

[irc]
server = "irc.libera.chat"         # port 6697 TLS by default
nick = "myphoenix"
channels = ["#mychannel"]
allowed_nicks = ["yournick"]

[matrix]
homeserver = "https://matrix.org"
token = "…"
user_id = "@you:matrix.org"
allowed_users = ["@you:matrix.org"]

[mattermost]
url = "https://mm.example.com"
token = "…"
allowed_users = ["you"]

[http]                             # web UI + APIs — see Web-UI
[memory]                           # embeddings for smarter recall
[audio]                            # voice transcription
[media]                            # image/video/music generation
[[jobs]]                           # cron: schedule = "0 9 * * *", prompt = "…"

Whatever you skip stays off. phoenix doctor reviews the result.