Configuration

Complete reference for config.toml. All sections and their defaults.

[provider]

Key	Type	Default	Description
`kind`	string	`"openai_compatible"`	Provider type: `openai_compatible`, `google_genai`, or `anthropic`
`api_key`	string	`—`	API key for the provider (required)
`base_url`	string	`"https://api.openai.com/v1"`	API base URL

[provider.models]

Key	Type	Default	Description
`primary`	string	`"openai/gpt-4o"`	Default model for general queries
`fast`	string	`"openai/gpt-4o-mini"`	Model for simple/quick queries
`smart`	string	`"openai/gpt-4o"`	Model for complex reasoning tasks

Model Routing

When all three tiers use the same model, auto-routing is disabled. See Model Routing for classification details.

[telegram]

Key	Type	Default	Description
`bot_token`	string	`—`	Telegram bot token from @BotFather (required)
`allowed_user_ids`	array	`[]`	Numeric Telegram user IDs allowed to chat. Empty = no restriction.

[state]

Key	Type	Default	Description
`db_path`	string	`"aidaemon.db"`	Path to SQLite database file
`working_memory_cap`	integer	`50`	Max messages per session kept in memory
`consolidation_interval_hours`	integer	`6`	Hours between memory consolidation runs

[terminal]

Key	Type	Default	Description
`allowed_prefixes`	array	`(see below)`	Command prefixes auto-approved without user confirmation

Default allowed prefixes:

text

ls, cat, head, tail, echo, date, whoami, pwd, find, wc,
grep, tree, file, stat, uname, df, du, ps, which, env, printenv

Shell Operators

Commands containing ; | && || $() or backticks always require approval, even if the prefix is whitelisted.

[daemon]

Key	Type	Default	Description
`health_port`	integer	`8080`	Port for the health check HTTP endpoint
`health_bind`	string	`"127.0.0.1"`	Bind address. Use "0.0.0.0" for external access.

[triggers.email]

Key	Type	Default	Description
`host`	string	`—`	IMAP server hostname (e.g., imap.gmail.com)
`port`	integer	`—`	IMAP port (typically 993 for TLS)
`username`	string	`—`	Email account username
`password`	string	`—`	Email account password or app-specific password
`folder`	string	`"INBOX"`	IMAP folder to monitor

[mcp.<name>]

Key	Type	Default	Description
`command`	string	`—`	Executable path or name for the MCP server
`args`	array	`[]`	Command-line arguments

[browser]

Key	Type	Default	Description
`enabled`	bool	`false`	Enable browser automation tool
`headless`	bool	`true`	Run Chrome in headless mode
`screenshot_width`	integer	`1280`	Screenshot viewport width in pixels
`screenshot_height`	integer	`720`	Screenshot viewport height in pixels
`user_data_dir`	string	`null`	Chrome user data directory for session reuse
`profile`	string	`null`	Chrome profile name (e.g., "Default", "Profile 1")

[skills]

Key	Type	Default	Description
`dir`	string	`"skills"`	Directory containing skill markdown files
`enabled`	bool	`true`	Enable the skills system

[subagents]

Key	Type	Default	Description
`enabled`	bool	`true`	Allow the agent to spawn sub-agents
`max_depth`	integer	`3`	Maximum nesting level for sub-agent recursion
`max_iterations`	integer	`10`	Max agentic loop steps per sub-agent invocation
`max_response_chars`	integer	`8000`	Truncate sub-agent responses beyond this length
`timeout_secs`	integer	`300`	Sub-agent execution timeout in seconds

[cli_agents]

Key	Type	Default	Description
`enabled`	bool	`false`	Enable CLI agent delegation tool
`timeout_secs`	integer	`600`	Global timeout for CLI agent execution
`max_output_chars`	integer	`16000`	Global max output length from CLI agents

[cli_agents.tools.<name>]

Key	Type	Default	Description
`command`	string	`—`	Command to execute
`args`	array	`[]`	Default arguments passed to the command
`description`	string	`—`	Tool description shown to the LLM
`timeout_secs`	integer	`null`	Override global timeout for this tool
`max_output_chars`	integer	`null`	Override global max output for this tool

Example Config

config.toml

[provider]
kind = "openai_compatible"
api_key = "sk-..."
base_url = "https://api.openai.com/v1"

[provider.models]
primary = "gpt-4o"
fast = "gpt-4o-mini"
smart = "o1-preview"

[telegram]
bot_token = "123456:ABC-DEF..."
allowed_user_ids = [123456789]

[state]
db_path = "aidaemon.db"
working_memory_cap = 50

[terminal]
allowed_prefixes = ["ls", "cat", "head", "tail", "echo", "date", "whoami"]

[daemon]
health_port = 8080

[mcp.filesystem]
command = "npx"
args = ["-y", "@anthropic/mcp-filesystem"]

[browser]
enabled = true
headless = true

[skills]
dir = "skills"
enabled = true

PreviousFirst Run Wizard NextProvider Setup