Introduction
Vibe-Kanban is a task management tool built specifically for developers who work with AI coding agents like Claude Code, Codex, and Cursor. It structures work into kanban-style columns so you can dispatch tasks to agents, track progress, and review results from a single TUI or web dashboard.
What Vibe-Kanban Does
- Provides a kanban board optimized for AI agent task assignment and tracking
- Integrates with popular AI coding agents to dispatch and monitor work
- Stores tasks locally in a Git-friendly format for version control
- Supports task dependencies, priorities, and agent assignment metadata
- Offers both a terminal UI and optional web dashboard
Architecture Overview
Vibe-Kanban is written in Rust for performance and ships as a single binary. Tasks are stored as structured YAML files in a .vibe/ directory within your project, making them diffable and committable alongside code. The TUI is built with ratatui, while the optional web view uses a lightweight embedded HTTP server. Agent integrations work through hooks that coding agents can read and update.
Self-Hosting & Configuration
- Install via
cargo install vibe-kanbanor download prebuilt binaries - Initialize in any project with
vibe-kanban init - Configure columns and workflow in
.vibe/config.yml - Set agent integration preferences per project
- All data stays local — no cloud dependency
Key Features
- Purpose-built for AI agent workflows, not retrofitted from human-only tools
- Git-native storage format for seamless version control integration
- Terminal UI with keyboard shortcuts for rapid task management
- Agent-readable task format that coding agents can parse and update
- Dependency graphs and priority scoring for intelligent task ordering
Comparison with Similar Tools
- Linear/Jira — cloud-hosted project management for teams; Vibe-Kanban is local-first and agent-aware
- Taskwarrior — powerful CLI task manager for humans; Vibe-Kanban adds agent dispatch semantics
- GitHub Issues — web-based tracking; Vibe-Kanban is local and optimized for agent interaction
- Plane — open-source Jira alternative; Vibe-Kanban focuses specifically on agent-driven development
FAQ
Q: Does Vibe-Kanban replace my existing project management tool? A: It is designed as a complementary tool for agent-driven coding workflows, not a full PM suite.
Q: Which AI coding agents are supported? A: It works with any agent that can read and write structured files, including Claude Code, Codex, and Cursor.
Q: Is there a hosted version? A: No. Vibe-Kanban is fully local and stores everything in your project directory.
Q: Can multiple developers share a board? A: Yes. Since tasks are Git-tracked YAML files, teams can collaborate via normal Git workflows.