A high-performance, terminal-native AI coding assistant built in Rust.
Single compiled binary. 14 LLM providers. Zero runtime dependencies. Your data stays local.
# macOS / Linux (Homebrew)
brew tap lijunzh/koda
brew install koda
# Cargo (requires Rust toolchain — MSRV 1.88)
cargo install koda-cli
# From source
git clone https://github.com/lijunzh/koda.git
cd koda && cargo build --release -p koda-cliOn first run, an onboarding wizard will guide you through provider and API key setup.
# Open the interactive fullscreen TUI
koda
# One-shot prompt (headless mode for scripts/CI)
koda "fix the failing test in auth.rs"
# Explicit model alias
koda -p "explain auth.rs" -m opus
# Pipe input directly into Koda
echo "review this diff" | koda
# Start the ACP server for editor/IDE integration
koda server --stdioInside the TUI, type /help to see all commands and keyboard shortcuts.
| Crate | Description |
|---|---|
| koda-cli | Terminal frontend (TUI + headless + ACP server) |
| koda-core | Engine library — providers, tools, inference loop |
| Resource | Description |
|---|---|
| User Manual | CLI reference, slash commands, trust modes, and custom agents |
| Engine API | Developer docs for embedding koda-core |
| Design | Architecture principles and philosophies |
| Contributing | Workspace layout, coding conventions, and tests |
| Changelog | Version history |
MIT