Configuration

OpenAlloy stores configuration in ~/.config/openalloy/config.yaml. You can edit it directly or use the CLI.

Config File Location

Platform Path
macOS/Linux ~/.config/openalloy/config.yaml
Windows %APPDATA%\openalloy\config.yaml

Setting Values

# Set a value
openalloy config set <key> <value>

# Get a value
openalloy config get <key>

# List all config
openalloy config list

Provider API Keys

openalloy config set anthropic.api_key sk-ant-xxx
openalloy config set openai.api_key sk-xxx
openalloy config set google.api_key AIza-xxx
openalloy config set mistral.api_key xxx

Default Provider

openalloy config set default.provider anthropic
openalloy config set default.model claude-sonnet-4-20250514

Modes

TUI Mode (default)

Interactive terminal UI with conversation history and model switching.

openalloy chat

Terminal Agent Mode

Non-interactive mode for scripting and automation.

echo "Summarize this file" | openalloy agent --file report.txt

WhatsApp Daemon Mode

Runs as a background service, bridging WhatsApp messages to LLM providers.

openalloy daemon --whatsapp

See WhatsApp Daemon for detailed setup.

Example Config

license_key: OA-XXXX-XXXX-XXXX
default:
  provider: anthropic
  model: claude-sonnet-4-20250514
anthropic:
  api_key: sk-ant-xxx
openai:
  api_key: sk-xxx
google:
  api_key: AIza-xxx
tui:
  theme: dark
  history_size: 1000
Installation Providers