KanbrAIn

Your AI agent's "Second Brain". Kanban-style task management designed for AI-assisted coding.

Features

• Kanban Board: Visual board with To Do, Doing, and Done columns
• Drag & Drop: Move tickets between columns with ease
• AI Task Spawning: Create markdown files for AI agent processing
• Markdown Sync: Status changes in markdown files sync back to the board
• Project Knowledge Base: "Brain" module to store and search project patterns/findings
• Data Optimization: Efficient file-based storage for tickets and knowledge entries to minimize token usage
• Local Storage: Project-specific .kanbrain/ folder stores all data

MCP Server Integration

KanbrAIn comes with a bundled Model Context Protocol (MCP) server that allows AI agents (like Claude Desktop or VS Code Copilot) to directly interact with your board.

Capabilities

• Manage Tickets: Create, update, move, and delete tickets
• Track Progress: Read and append to ticket progress logs
• Knowledge Base: Search and contribute to the project's knowledge base

Tools

Configuration

Add this to your MCP settings (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "kanbrain": {
      "command": "node",
      "args": ["/absolute/path/to/extension/out/mcp/server.js"]
    }
  }
}

Note: You do not need to specify the workspace path. The server automatically detects the active VS Code workspace.

Tip: Use the command KanbrAIn: Copy MCP Configuration to automatically generate the config for your current workspace.

Installation

Install from Extension Marketplace:

• Open Command Palette (Ctrl+Shift+P) and run "KanbrAIn: Open Kanban Board"

Install from Source:

1. Open this project in VS Code
2. Press F5 to run the extension in development mode
3. In the Extension Development Host window, open a project folder
4. Open Command Palette (Ctrl+Shift+P) and run "KanbrAIn: Open Kanban Board"

Usage

Opening the Board

• Command Palette: KanbrAIn: Open Kanban Board

Creating Tickets

• Click + New Ticket in the board header
• Or use Command Palette: KanbrAIn: Create New Ticket

Moving Tickets

• Drag and drop tickets between columns
• Click Edit to manually change status

Spawning AI Tasks

1. Click 🤖 AI Task on any ticket
2. A markdown file is created at .kanbrain/tasks/{ticket-id}.md
3. The file opens automatically in the editor
4. AI agents can read this file and update the CURRENT_STATUS line
5. Status changes sync back to the Kanban board automatically

Knowledge Base (Brain)

• Click the Brain button in the top header to switch views.
• Add Findings: Store reusable patterns, code snippets, or architecture decisions.
• Search: Instantly filter your knowledge base by content or tags.
• Integration: AI agents can search and read these entries to verify decisions.

Data Storage

All data is stored locally in your project under .kanbrain/:

• database.json - Ticket database
• tasks/*.md - AI task markdown files
• knowledge/index.json - Knowledge base index
• knowledge/*.md - Knowledge base markdown files
• descriptions/*.md - Ticket description markdown files

Commands

Development

# Install dependencies
npm install

# Compile TypeScript
npm run compile

# Watch for changes
npm run watch

# Lint
npm run lint

# Package extension
npm run package

License

MIT