Installation

Quick install

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/sageil/kodacode/main/install.sh | sh

That installs kodacode to /usr/local/bin/kodacode.

Homebrew

brew tap sageil/tap
brew install --cask kodacode

Go install

go install github.com/sageil/kodacode/cmd/kodacode@latest

Requires Go 1.26+.

This path installs only kodacode. Search is built into the app; no separate search binary is required.

From source

git clone https://github.com/sageil/kodacode.git
cd kodacode
task build
mv bin/kodacode /usr/local/bin/

Requires Go 1.26+ and Task.

Configuration and storage

KodaCode keeps configuration and credentials separate:

• ~/.config/kodacode/config.yaml: model routing, budgets, search, execution policy, theme
• ~/.config/kodacode/auth.yaml: provider credentials and OAuth state

By default it also writes runtime data to:

• ~/.local/share/kodacode/kodacode.db: SQLite session, event, tool-result, and background-log store
• ~/.local/share/kodacode/models-cache.json: model catalog cache
• ~/.local/state/kodacode/search: default search index

If you use XDG overrides, those paths move under XDG_CONFIG_HOME, XDG_DATA_HOME, and XDG_STATE_HOME instead.

The TUI can stage provider setup through /connect, or you can write those files manually. See Providers for supported provider IDs, API-key examples, OAuth notes, and OpenAI-compatible endpoint configuration.

Next steps

After installation:

1. Connect a model account with /connect or follow Providers for manual setup
2. Read Quick Start for the first session flow
3. Use Common Workflows to pick the right path for daily use
4. Use Configuration when you want saved defaults