Koda is a terminal coding agent built for OpenAdapter. One key gives you many models — and Koda wraps a reliability layer around them so cheaper, faster models still ship working code: it never idles on rate limits, fails over when a model stalls, verifies its own work, and steps up to a stronger model only when it has to.

It runs in your terminal like the coding CLIs you already know — just harder to break, and tuned end-to-end for OpenAdapter.

Install

npm i -g @openadapter/koda@beta
koda

First launch signs you in through the browser: approve the request on your dashboard and Koda wires up models, tools, and skills automatically. No browser handy? Paste a key (sk-cv-…) or run koda setup sk-cv-….

koda                 # start (or resume) in the current folder
koda --continue      # reopen the latest session here
koda --resume        # pick a past session
koda setup           # re-run setup any time
koda import          # pull in past sessions from other CLIs (see below)

What makes Koda different

One key, many models — tiered. Point Koda at any OpenAdapter model (max / pro / lite). Koda reads live health/latency signals to route well, and you stay on your pick.

Reliability that keeps cheap models honest:

• Never idle on a rate limit — /zenitsu speed mode instantly reroutes a 429 to a healthy, faster model (no waiting), then snaps back to your preferred one the moment it's free.
• Failover, not failure — provider/model hiccups are retried and routed around; a request rarely dies from a single flake.
• Run-it verification — when code changed, Koda runs your build/tests/lint and treats the exit code as ground truth, not the model's opinion.
• Overseer + escalation — a stronger model double-checks "done" on smaller models and, if it's stuck, Koda climbs the tier ladder — capped, then sticks.
• Heal, don't crash — loop/state errors recover instead of killing your session; repetition/garbage output is detected and replaced.

Features that respect your time:

• Ask & suggest — on open-ended requests Koda proposes an approach and asks the decisions that matter (framework, storage…) with a clean multiple-choice card, instead of guessing wrong.
• Vision on any model — paste a screenshot even on a non-vision model; Koda reads it with a vision model and passes the details along.
• Bring your history — koda import (and a first-run prompt) imports past sessions from Claude Code and OpenCode into Koda, organized by project. Nothing left behind.
• Memory, web, background tasks — remember/recall with semantic search, web search + fetch, and long-running servers via run_background.
• Skills & modes — drop-in Agent Skills (frontend, debugging, code-review), /plan and /build modes.
• Stays current — checks for updates and updates itself in the background; the model list auto-refreshes daily so you always have the newest models.
• Calm, useful UX — live working indicator, an end-of-task recap, a session-resume hint when you reopen a folder, and contextual tips that surface the right feature exactly when it helps.

Common commands

| Command | What it does | |---|---| | /zenitsu | Toggle speed mode (never wait on a rate limit) | | /goal | Set a session goal Koda tracks to completion | | /plan · /build | Switch between plan and build modes | | /resume · /continue | Open a past session | | /memory · /todos | Memory and task list | | /use <skill> | Keep a skill active for the session | | /trace | What the harness did (failover / verify / escalate …) | | /settings | Settings (incl. "Import past sessions") | | /help | Full help |

Configuration (env flags)

| Flag | Effect | |---|---| | KODA_ZENITSU=1 | Start in speed mode | | KODA_NO_AUTO_UPDATE=1 | Notify about updates but don't auto-install | | KODA_NO_MODEL_REFRESH=1 | Don't auto-refresh the model list | | KODA_NO_RESUME_HINT=1 | Hide the "past sessions in this folder" hint | | KODA_TIPS=0 | Disable contextual feature tips | | KODA_OFFLINE=1 | No network calls (version check, model refresh, tool downloads) |

Built on Pi — credit where it's due

Koda stands on Pi, the excellent open-source terminal coding harness by Mario Zechner (@badlogic). A huge amount of what makes Koda pleasant to use is Pi's, and we're grateful for it.

Pi provides the foundation — the interactive TUI + editor, sessions & branching, context compaction, the extension / skill / prompt-template / theme system, prompt-template and package management, and the interactive / print / RPC / SDK run modes.

Koda adds, on top of Pi:

• OpenAdapter integration (one key → many tiered models) and the first-run setup.
• The reliability layer — zenitsu never-idle rerouting, model failover, run-it verification, the overseer + escalation, heal-don't-crash, poison guard.
• Ask & suggest, the vision bridge, session import from Claude Code & OpenCode.
• Auto-update + daily model refresh, the resume hint, contextual tips, recap, and the live status UX.

Thank you to the Pi project and its contributors.

License

MIT — see LICENSE. Copyright © Mario Zechner (original "pi" project) and OpenAdapter (the "Koda" fork).