kkārya
roadmap

What exists, and what comes next.

Karya is pre-1.0. The MVP below is what the binary does today. Deferred items are planned and not built; each one is labelled roadmap wherever it appears on this site.

status: pre-1.0 · interfaces may change

In the MVP

built
terminal UIFull-screen interface with a streaming response viewport and a usage and cost summary per task.
four toolsread, write, edit and bash, with bounded reads, atomic writes, exact-match edits and tail-preserving shell output.
approval gatewrite, edit and bash show a diff or the exact command and wait. Denials return to the model as structured results.
provider interfaceOne internal interface. The model is selected with HARNESS_MODEL, the endpoint with HARNESS_BASE_URL.
OS sandboxsandbox-exec on macOS, bubblewrap with seccomp on Linux. Writable scope is the root and a session temp dir; network off by default.
root-confined pathsFile tools reject absolute, escaping and symlink-escaping paths.
portable sessionsAppend-only JSONL keyed to the git remote URL. Resume on any machine, with a drift note for HEAD, dirty tree and platform.
cost and limitsPer-turn tokens, cost, duration and tool outcomes. HARNESS_MAX_STEPS and HARNESS_MAX_COST stop the loop and leave the session resumable.
installgo install from the module path.

Deferred

not built
roadmap

Container executor

Run commands inside a container, behind the same executor interface the OS sandbox uses today. The loop and the approval flow stay the same.

roadmap

Shadow-git snapshots

Snapshot the worktree into a shadow git repository before each bash command, so the side effects of a shell command can be undone.

roadmap

Encrypted session sync

Sync session logs between machines with encryption on the client. The server stores ciphertext and can never read session content.

roadmap

Distribution

A Homebrew tap and prebuilt release binaries, so installing does not require a Go toolchain.