Skip to main content

​
Supported Systems

We build and test Vibe Kanban on the following systems:
  • macOS (Intel and Apple Silicon)
  • Linux
  • Windows

​
Prerequisites

Before installing Vibe Kanban, ensure you have:
  • Node.js: Latest LTS version recommended
  • Coding agent authentication: Authenticate with your preferred coding agents outside of Vibe Kanban
All supported coding agents can be used via npx without separate installation. You can find authentication instructions for each coding agent on their respective websites.

​
Safety Notice

Vibe Kanban runs AI agents with —dangerously-skip-permissions/—yolo flags by default so they can work autonomously without constant approval prompts. Each task runs in an isolated git worktree, preventing agents from interfering with each other. Agents can still perform system-level actions, so review their work and keep backups.

​
Installation & Setup

1

Install and launch Vibe Kanban

Open a terminal and run:
npx vibe-kanban
The application will bind to a random free port, print the URL in the terminal, and automatically open in your default browser.
2

Complete initial setup

Complete the setup dialogs to configure your coding agent and editor preferences. GitHub authentication is optional and can be configured later.
3

Create your first project

You’ll land on an empty Projects page. Click “Create your first project” to set up your initial project.
4

Add tasks

Start tracking your work by creating tasks within your project.
5

Optional: Configure GitHub integration

Connect to GitHub in Settings to enable branch management and pull request creation.
6

Optional: Set up MCP integration

Streamline task creation with coding agents by setting up MCP integration.
To use a fixed port, specify the PORT environment variable: PORT=8080 npx vibe-kanban
⌘I