Vibeflow
Local kanban board where coding agents claim tasks and bug reports carry full context
- Pricing
- Open source
- Platforms
- CLI, self-hosted, macOS
- Runs
- Locally
- Version
- 0.26.0
- Listing updated
- 3 days ago
About Vibeflow
Vibeflow is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
Bug reports arrive as structured tasks. Press Alt+A on a running page, click the broken element and type one line; the task is created with the CSS selector, URL, source file and line, screenshot and console errors already attached. No browser extension is needed, since a script tag or bookmarklet arms the page.
The board runs on your machine and every task is a JSON file in a .vibeflow folder in the repo, so it can be committed, diffed or deleted. Tasks move from backlog to todo, in-progress, review and done, with parent and child tasks, filters and an activity feed. An agent claims the next task atomically with the --next flag, posts progress, and hits a review gate where a human verifies before work lands.
The MCP server runs over stdio from the @vibeflow-tools/cli npm package and needs Node.js 22 or newer. Configure one server per project with a required --project path, so a call cannot write into the wrong project. The CLI is Apache-2.0 licensed and needs no account or cloud.
Install
Run in a terminal
claude mcp add vibeflow -- npx -y @vibeflow-tools/cliAdd to claude_desktop_config.json
{
"mcpServers": {
"vibeflow": {
"command": "npx",
"args": [
"-y",
"@vibeflow-tools/cli"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"vibeflow": {
"command": "npx",
"args": [
"-y",
"@vibeflow-tools/cli"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"vibeflow": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@vibeflow-tools/cli"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"vibeflow": {
"command": "npx",
"args": [
"-y",
"@vibeflow-tools/cli"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"vibeflow": {
"command": "npx",
"args": [
"-y",
"@vibeflow-tools/cli"
]
}
}
}What it does
- Click-to-ticket annotation
- Alt+A and a click create a task with selector, file and screenshot.
- Atomic next-task claim
- Agents take the next task with one call so two agents do not collide.
- Review gate
- Agents ask for human verification and receive a verdict before work lands.
- Parent and child tasks
- Split an epic into children that keep their own status and history.
- Local-first storage
- Tasks are JSON files inside the repo, with no database or account.
- Project-scoped MCP server
- One server per project with a validated root.
Good for
- Report UI bugs to a coding agent with exact element context
- Sequence agent work on a kanban board
- Require human sign-off on agent changes
- Split a feature into leaf tasks agents can pick up
- Keep task history under version control
Pricing
Open source
Apache-2.0; free in local mode
Prices change. Check vibeflow.tools before you buy.
Vibeflow FAQ
Does it need an account or cloud service?
No. It is local-first, with tasks stored as JSON in your repo.
What is required to run it?
Node.js 22 or newer; run it with npx @vibeflow-tools/cli kanban.
What licence is it under?
Apache-2.0.
Why is --project required for MCP?
The server resolves its project root once at startup, so a call cannot write into the wrong project.
Is Vibeflow free?
Yes. Vibeflow is open source, so you can use and self-host it for free.
How do I add Vibeflow to Claude Code?
Run this command in your terminal: claude mcp add vibeflow -- npx -y @vibeflow-tools/cli
What are the best alternatives to Vibeflow?
The closest alternatives to Vibeflow are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to Vibeflow

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity