Configuration
Main configuration paths and options for annodex.
Configuration Directory
Annodex stores its configuration in:
~/.config/annodex/Key Files
| File | Purpose |
|---|---|
providers.json | LLM provider and model definitions |
annodex-projects.json | Project directory registry |
Providers and Models
See Models for detailed provider and model configuration.
Project Registry
Annodex tracks which directories are used as project workspaces in:
~/.config/annodex/annodex-projects.jsonProjects are auto-registered when you open a directory in the workspace. Each project maintains its own chat threads, file context, and session history.
Codex Integration
Annodex is fully compatible with existing Codex CLI installations:
- Config: reads
~/.codexconfiguration (API keys, model preferences) - History: browses and resumes threads from
~/.codexchat history - No migration needed: just install annodex alongside your existing Codex setup
Runtime Behavior
Annodex automatically:
- Starts a local server on port 30121 (configurable)
- Connects to the Codex app-server for thread/turn execution
- Manages SSE streams for real-time event delivery
- Idles sessions after 10 minutes of inactivity