Self-hosted Kanban board with browser terminals for AI coding agents. Hook-driven auto-tracking — manage tmux/zellij sessions and git worktrees from one board.
A web-based terminal Kanban board for managing AI coding agent (Claude Code, Gemini CLI, Codex CLI, etc.) tasks in real-time.
Monitor tmux/zellij sessions directly in your browser while tracking task progress on a drag & drop Kanban board.
Automatically track task status via AI Agent Hooks — no manual updates needed.
Buying me a coffee is nice, but honestly? A contribution would make my day even more. :)
This command checks dependencies (with i18n install prompts), installs packages, starts PostgreSQL, runs migrations, builds, and launches the server.
bash kanvibe.sh stop
Stops the KanVibe server and PostgreSQL container.
Open http://localhost:4885 in your browser.
Usage Flow
1. Register a Project
Search for your local git repository using the fzf-style folder search in project settings. KanVibe scans the directory and automatically detects existing worktree branches.
2. Create Tasks
Add a TODO task from the Kanban board. When creating a task with a branch name, KanVibe automatically:
Creates a git worktree for the branch
Spawns a tmux window or zellij tab for the session
Links the terminal session to the task
3. Work with the Kanban Board
Tasks are managed through 5 statuses: TODO → PROGRESS → PENDING → REVIEW → DONE
Change statuses via drag & drop, or let AI Agent Hooks transition them automatically. When a task moves to DONE, its branch, worktree, and terminal session are automatically deleted.
4. Select Pane Layouts
Each task's terminal page supports multiple pane layouts:
| Layout | Description |
|--------|-------------|
| Single | One full-screen pane |
| Horizontal 2 | Two panes side by side |
| Vertical 2 | Two panes stacked |
| Left + Right TB | Left pane + right top/bottom split |
| Left TB + Right | Left top/bottom split + right pane |
| Quad | Four equal panes |
Each pane can run a custom command (e.g., vim, htop, lazygit, test runner, etc.). Configure layouts globally or per-project from the settings dialog.
Automatic git worktree creation when a branch-based task is created
Worktree scanning: existing branches are auto-registered as TODO tasks
Automatic cleanup (branch + worktree + session) when task moves to DONE
Terminal Sessions (tmux / zellij)
tmux and zellij are both supported as terminal multiplexers
Browser-based terminal via xterm.js + WebSocket
SSH remote terminal support (reads ~/.ssh/config)
Nerd Font rendering support
AI Agent Hooks - Automatic Status Tracking
KanVibe integrates with Claude Code Hooks, Gemini CLI Hooks, Codex CLI, and OpenCode to automatically track task status. Tasks are managed through 5 statuses:
| Status | Description |
|--------|-------------|
| TODO | Initial state when a task is created |
| PROGRESS | AI is actively working on the task |
| PENDING | AI asked a follow-up question; waiting for user response (Claude Code only) |
| REVIEW | AI has finished; awaiting review |
| DONE | Task complete — branch, worktree, and terminal session are automatically deleted |
Claude Code
User sends prompt → PROGRESS
AI asks question (AskUser) → PENDING
User answers → PROGRESS
AI finishes response → REVIEW
Gemini CLI does not have an equivalent to Claude Code's AskUserQuestion, so the PENDING state is not available.
Codex CLI (Partial Support)
agent-turn-complete (agent done) → REVIEW
Codex CLI currently only supports the agent-turn-complete notification event via the notify config. PROGRESS and PENDING transitions are not yet available. OpenAI is actively designing a hooks system — full support will be added when it ships.
OpenCode
User sends message (message.updated, role=user) → PROGRESS
AI asks a question (question.asked) → PENDING
User answers question (question.replied) → PROGRESS
Session idle (session.idle) → REVIEW
OpenCode uses its own plugin system instead of shell-script hooks. KanVibe generates a TypeScript plugin at .opencode/plugins/kanvibe-plugin.ts that subscribes to OpenCode's native event hooks (message.updated, question.asked, question.replied, and session.idle) via the @opencode-ai/plugin SDK. This means status updates are handled in-process without spawning external shell commands.
All agent hooks are auto-installed when you register a project through KanVibe's directory scan or create a task with a worktree. You can also install them individually from the task detail page.
Configurable — Enable/disable per project and filter by status (PROGRESS, PENDING, REVIEW, DONE)
Setup: Browser will prompt for permission on first visit. Configure filters in Project Settings → Notifications.
Hook API Endpoints
| Endpoint | Method | Description |
|----------|--------|-------------|
| /api/hooks/start | POST | Create a new task |
| /api/hooks/status | POST | Update task status by branchName + projectName |
GitHub-style Diff View
Review code changes directly in the browser with a GitHub-style diff viewer. Click the Diff badge on the task detail page to see all modified files compared to the base branch.
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.
