KodaCode

truly yours.

The composable AI coding agent for your terminal.

kodacode — ~/project

  _  __         _          ____          _
 | |/ /___   __| | __ _   / ___|___   __| | ___
 | ' // _ \ / _` |/ _` | | |   / _ \ / _` |/ _ \
 | . \ (_) | (_| | (_| | | |__| (_) | (_| |  __/
 |_|\_\___/ \__,_|\__,_|  \____\___/ \__,_|\___|

  builder · claude-sonnet-4-20250514 · main

▸ refactor the auth middleware to use JWT validation

  Planning...
  ✓ Read internal/middleware/auth.go
  ✓ Read internal/auth/jwt.go
  ✓ Created plan (4 steps)
  → Waiting for approval

Agent system

Builder writes code directly. Engineer researches, plans, and waits for approval. Custom agents via markdown. Switch with Tab.

Agents:
  ▸ builder    direct implementation
  ▹ engineer   explore → plan → execute
  ▹ adviser    read-only research
  ▹ refactor   structural changes

Sandboxed

Every tool call confined to your project. Path escapes and external access need permission.

Multi-provider

Anthropic, OpenAI, Google, Groq, Ollama, or any compatible endpoint. Switch mid-session.

20+ built-in tools

File ops, shell, code search, LSP go-to-definition, rename, diagnostics, git, background tasks.

read  write  edit  glob  grep  bash
lsp_definition  lsp_references  lsp_hover
lsp_rename  lsp_diagnostics
git  web_fetch  web_search
create_agent  background_task  + MCP

Semantic code search

Hybrid search combines keyword matching (FTS5) with embedding-based vector search. Index every symbol in your codebase with embeddings from OpenAI, LM Studio, or Ollama.

▸ search query="authentication middleware"

Symbol matches:  (fts + vector)
  internal/middleware/auth.go:45  function  ValidateJWT
  internal/auth/session.go:12    function  NewAuthMiddleware
  internal/handler/login.go:28   function  HandleLogin

Cost control

Utility model routing, adaptive reasoning budgets, per-session budget caps.

LSP intelligence

Auto-discovers language servers. Auto-lints after every edit. Errors fixed in the same turn.

Sessions & snapshots

Persistent sessions with branching. Per-turn git snapshots. Resume or replay any state.

Project memory

Global, project, and personal instructions via KODACODE.md. Conventions carry across sessions.

MCP integration

Extend with any MCP server, whether it uses stdio or SSE. Tools appear alongside the built-ins under the same permissions.

Context management

Pruning, compaction, and safety limits keep long sessions coherent. Never loses track.

Model routing

Route background tasks to cheap utility models, reviews to a separate model, and configure fallback chains for resilience.

Install

macOS / Linux

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

Homebrew

brew tap sageil/tap && brew install kodacode

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

Then run kodacode to start.