# Vibeflow

> Vibeflow is an open-source MCP server for developer tools. Local kanban board where coding agents claim tasks and bug reports carry full context. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Windows, Linux
- **Website:** https://www.vibeflow.tools
- **Repository:** https://github.com/zorcec/vibeflow/tree/HEAD/packages/cli
- **MCP Registry name:** io.github.zorcec/vibeflow
- **Categories:** developer tools, productivity
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add vibeflow -- npx -y @vibeflow-tools/cli
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "vibeflow": {
      "command": "npx",
      "args": [
        "-y",
        "@vibeflow-tools/cli"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "vibeflow": {
      "command": "npx",
      "args": [
        "-y",
        "@vibeflow-tools/cli"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "vibeflow": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@vibeflow-tools/cli"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "vibeflow": {
      "command": "npx",
      "args": [
        "-y",
        "@vibeflow-tools/cli"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "vibeflow": {
      "command": "npx",
      "args": [
        "-y",
        "@vibeflow-tools/cli"
      ]
    }
  }
}
```

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/vibeflow
