Repository navigation
Home
A web UI for the Claude Code and Codex CLIs. Long sessions, many projects, no chrome.
A web UI for the Claude Code and Codex CLIs, built for long sessions across many projects. OAuth pool rotation, kanban-driven worktrees, subagent orchestration, durable approvals. No dashboard chrome.
bun install -g @cuongtran001/kannaInstall guide · View on GitHub


Register one Claude OAuth token, or several. Kanna picks the least-loaded one per chat and falls over automatically when a token hits a rate limit, so a long session does not stop at the first limit you reach.
Codex and OpenRouter sit beside Claude in the same composer. Switch provider mid-chat; previous turns stay where they are.

Configure named subagents with their own system prompts and tool
surfaces. The main agent decides when to delegate, calls
mcp__kanna__delegate_subagent, and synthesizes the reply back into
its own turn. Cycle detection and depth limits run on every
delegation. Live progress bubbles up to the transcript without a
separate window.

Tool calls render hydrated with collapsible groups. File diffs show
inline. Plan-mode and AskUserQuestion prompts route through a
durable approval protocol, so pending requests survive server
restarts and replay on reconnect. Thinking, text and tool input stream
in live while the model writes them, so a long turn never looks hung.

Chats live under projects with live status (idle, running, waiting, failed). Kanna auto-discovers projects from your local Claude and Codex history, imports existing sessions with one click, and resumes them with the full transcript intact.
Each project also gets a kanban board. Starting work on a card cuts a branch, a git worktree and a chat in one gesture — which is what makes three agents working at once safe from each other.
Undercroft is an open-source, Vietnamese-first data platform that takes any REST source through an immutable raw lake and Postgres into dbt models and BI, and serves an MCP endpoint that Kanna connects to as an MCP client over OAuth. See its source and blog.
This wiki is generated from wiki/src/content/docs in cuongtranba/kanna.
Edit the docs there: changes made on this wiki are overwritten on the next sync.
The same docs are published at https://kanna-wiki.lowbit.link.
Getting Started
Features
- Providers & Models
- Chat & Transcript
- Generative UI
- Projects & Sessions
- Boards
- Multi-repo Stacks
- Slash Commands
- Cron Jobs
- Loops
- Beacons
- Kanna Plugins
- Package Auto-Update
- Advanced
- Security
Guides
- User Guide
- Contributing
- Ops & Self-Host
Sharing
Reference