repository·main·Indexed 12 days ago
https://github.com/bloopai/vibe-kanbanA planning and execution platform for software engineers using AI coding agents. It features kanban boards for task planning and workspaces where agents (such as Claude, Amp, or Echo) can execute tasks with access to git branches, terminals, and dev servers. The platform supports isolated git worktrees, one-click merging, and integration with editors like VS Code, Cursor, and Zed.
@vibe/ui package provides shared UI primitives and reusable web application components for the Vibe Kanban ecosystem. It includes package scaffolding, exports, and shared utility helpers like cn (typically used for conditional Tailwind class merging).The Workspaces UI provides several integrated tools for an AI-assisted development workflow:
Vibe Kanban integrates with several coding agents to facilitate task attempts. Each agent must be installed and authenticated on your system before it can be selected within the Vibe Kanban interface.
Supported agents include:
A project is a container for related work within your organisation, serving as a dedicated space for a specific initiative, product, or team goal.
Each project includes:
An issue is a single work item (e.g., bug, feature, task) tracked on a kanban board. Each issue contains the following properties:
TASK-123).A task attempt represents a single session with a coding agent working against a specific task. While most tasks require only one attempt, you should create additional attempts when you need a fresh restart with different configurations.
Use a new task attempt to:
A workspace is a task execution environment where you work with coding agents. It provides an isolated environment for your development tasks through the following mechanisms:
.vibe-kanban-workspaces directory (configurable in Settings → General → Workspace Directory).main). The branch name is auto-generated based on your task description (e.g., vk/abc123-add-login-page).npm install) run automatically to prepare the environment.A workspace is an isolated, IDE-like environment designed for completing specific coding tasks using AI coding agents. It serves as a dedicated "project room" where you can chat with agents, review code changes, test applications via a built-in browser, and eventually create pull requests.
The Settings dialog is organized into several functional tabs:
| Tab | Description |
|---|---|
| General | Appearance, default agent, editor, git, and notifications |
| Projects | Project-specific settings |
| Repositories | Repository scripts (dev server, setup, cleanup) |
| Organization Settings | Organisation members, invitations, and settings |
| Remote Projects | Cloud-synced projects across organisations |
| Agents | Agent profiles and variants |
| MCP Servers | Model Context Protocol server configuration |
The frontend architecture is being transitioned from a monolithic structure in packages/local-web/src/components to a modular system using a new @vibe/ui package. The refactor follows a specific categorization for components to ensure proper decoupling:
extract-now: These components are the highest priority for the first wave of the @vibe/ui package migration. They typically include core UI elements from components/ui and specific components/ui-new/primitives.extract-later: Reusable components that should only be moved to the UI library after their APIs and dependencies have been decoupled from the main application.keep-app: Components that should remain within the frontend application package. These are typically feature-specific, domain-driven, or integration-focused UI elements (e.g., containers, views, and feature-specific dialogs).Issues in the List View are grouped by status. Each status section includes:
Each row displays the following metadata:
ISS-1).12d).Clicking any row opens the full issue panel.