README
¶
Turns AI from "suggestion generator" into "work executor"
How It Works
Use builder when the task is clear and contained. Use engineer when the task is broad, risky, architectural, or needs an approved plan before edits
Goal: Build a calculator that estimates monthly payment, total interest, and affordability range.
Acceptance criteria:
- Inputs: home price, down payment, interest rate, amortization years, property tax, insurance, condo fees, gross monthly income, monthly debts.
- Outputs: loan amount, estimated monthly principal + interest, total monthly housing cost, debt-to-income ratio, and affordability status.
- Use standard fixed-rate mortgage amortization math.
- Validate invalid inputs clearly.
- Add focused tests for payment calculation, DTI calculation, and edge cases.
- Do not use fake values or hardcoded backend state.
- Run the relevant test suite before finishing.
Before editing:
- Inspect the existing app structure.
- Propose a short implementation plan.
- Wait for approval before making code changes.
Agents
- builder Default, project path sandboxed agent for development work
- Planner Read-only research and advisory agent
- More Agents
Features
Install
# Homebrew
brew tap sageil/tap && brew install --cask kodacode
# Quick install
curl -fsSL https://raw.githubusercontent.com/sageil/kodacode/main/install.sh | sh
# Quick install without bundled rg
KODACODE_INSTALL_RG=0 curl -fsSL https://raw.githubusercontent.com/sageil/kodacode/main/install.sh | sh
# Go
go install github.com/sageil/kodacode/cmd/kodacode@latest
Quick Start
# Optional: authenticate with a provider
kodacode login openai
# Start
kodacode
Configure providers with /connect, then choose a model route such as
openai/gpt-5. See the model routing docs
for provider IDs and OAuth-specific routes.
Type your message and press Enter. KodaCode handles the rest.
Documentation
Full documentation, configuration reference, and guides are available at kodacode.dev.
License
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
kodacode
command
Package main wires the kodacode CLI and terminal application entrypoints.
|
Package main wires the kodacode CLI and terminal application entrypoints. |
|
internal
|
|
|
agent
Package agent loads agent definitions, catalogs, and built-in agent behavior.
|
Package agent loads agent definitions, catalogs, and built-in agent behavior. |
|
app
Package app orchestrates sessions, turns, tools, and provider execution.
|
Package app orchestrates sessions, turns, tools, and provider execution. |
|
bootstrap
Package bootstrap builds application defaults used during startup.
|
Package bootstrap builds application defaults used during startup. |
|
configdir
Package configdir resolves kodacode user configuration directories.
|
Package configdir resolves kodacode user configuration directories. |
|
engine
Package engine defines the model-facing execution interface used by runtimes.
|
Package engine defines the model-facing execution interface used by runtimes. |
|
events
Package events defines durable session events, replay storage, and projection.
|
Package events defines durable session events, replay storage, and projection. |
|
lsp
Package lsp manages language server discovery, startup, and query execution.
|
Package lsp manages language server discovery, startup, and query execution. |
|
mcp
Package mcp manages stdio MCP servers and their runtime registration.
|
Package mcp manages stdio MCP servers and their runtime registration. |
|
observability
Package observability provides structured logging and retention helpers.
|
Package observability provides structured logging and retention helpers. |
|
permissionpolicy
Package permissionpolicy matches declarative permission rules against requests.
|
Package permissionpolicy matches declarative permission rules against requests. |
|
prompt
Package prompt compiles prompt fragments into provider-ready instructions.
|
Package prompt compiles prompt fragments into provider-ready instructions. |
|
provider
Package provider integrates model providers and normalizes their request flows.
|
Package provider integrates model providers and normalizes their request flows. |
|
search
Package search indexes workspaces and serves lexical and semantic search.
|
Package search indexes workspaces and serves lexical and semantic search. |
|
sessiontitle
Package sessiontitle derives concise session titles from user prompts.
|
Package sessiontitle derives concise session titles from user prompts. |
|
skill
Package skill loads, parses, and indexes user and project skills.
|
Package skill loads, parses, and indexes user and project skills. |
|
textdiff
Package textdiff renders compact previews of text mutations.
|
Package textdiff renders compact previews of text mutations. |
|
textutil
Package textutil provides shared text accumulation and truncation helpers.
|
Package textutil provides shared text accumulation and truncation helpers. |
|
tool
Package tool defines tool contracts and built-in tool implementations.
|
Package tool defines tool contracts and built-in tool implementations. |
|
tui
Package tui renders the terminal interface and maps runtime state to views.
|
Package tui renders the terminal interface and maps runtime state to views. |
|
tui/theme
Package theme loads, catalogs, and applies terminal UI themes.
|
Package theme loads, catalogs, and applies terminal UI themes. |
|
websearch
Package websearch provides web search backend implementations.
|
Package websearch provides web search backend implementations. |
|
workspace
Package workspace defines workspace scope, grants, and path authorization.
|
Package workspace defines workspace scope, grants, and path authorization. |
Click to show internal directories.
Click to hide internal directories.