Skip to content
MCP server

Vibeflow

Local kanban board where coding agents claim tasks and bug reports carry full context

Runs locallyStatus and history
Install
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/cli

Add to claude_desktop_config.json

{
  "mcpServers": {
    "vibeflow": {
      "command": "npx",
      "args": [
        "-y",
        "@vibeflow-tools/cli"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "vibeflow": {
      "command": "npx",
      "args": [
        "-y",
        "@vibeflow-tools/cli"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity