Enable Kanban

enable-kanban

Execute the following steps IN ORDER using your tools directly. Do NOT delegate to other agents.

Step 1: Detect project root

Use the Bash tool to run: git rev-parse --show-toplevel

If it fails, run: pwd

Store the result as PROJECT_ROOT. PROJECT_NAME = the last path component of PROJECT_ROOT.

Step 2: Locate the kanban server

Use the Bash tool to check: ls ~/Projects/dynamic-kanban-mcp/mcp-kanban-server.py 2>/dev/null && echo FOUND || echo NOT_FOUND

If FOUND: SERVER_DIR = /home/$USER/Projects/dynamic-kanban-mcp (expand the actual home path).

If NOT FOUND: check ~/.local/share/cc-board/server/mcp-kanban-server.py. If also not found, run:

mkdir -p ~/.local/share/cc-board
git clone https://github.com/talpah/dynamic-kanban-mcp ~/.local/share/cc-board/server

Then SERVER_DIR = ~/.local/share/cc-board/server.

Step 3: Verify the KANBAN_DATA_DIR patch

Use the Bash tool: grep -q "KANBAN_DATA_DIR" SERVER_DIR/config.py && echo PATCHED || echo NOT_PATCHED

If NOT_PATCHED, use the Edit tool to update get_progress_file_path in SERVER_DIR/config.py. Find this exact method body:

return str(Path(__file__).parent / "kanban-progress.json")

Replace it with:

data_dir = os.getenv("KANBAN_DATA_DIR")
if data_dir:
    return str(Path(data_dir) / "kanban-progress.json")
return str(Path(__file__).parent / "kanban-progress.json")

Step 4: Install Python dependencies

Use the Bash tool: cd SERVER_DIR && uv sync

Step 5: Create project data directory

Use the Bash tool: mkdir -p PROJECT_ROOT/.kanban

Step 6: Write .mcp.json

Read PROJECT_ROOT/.mcp.json with the Read tool if it exists. Merge in — or create — the following entry under mcpServers, then write it back with the Write tool. Use EXACT field names and values shown. Replace SERVER_DIR and PROJECT_ROOT with actual absolute paths:

{
  "mcpServers": {
    "kanban": {
      "command": "uv",
      "args": ["run", "--project", "SERVER_DIR", "python", "SERVER_DIR/mcp-kanban-server.py"],
      "env": {
        "KANBAN_DATA_DIR": "PROJECT_ROOT/.kanban",
        "KANBAN_WEBSOCKET_HOST": "127.0.0.1"
      }
    }
  }
}

Step 6b: Register the MCP server in local scope

The .mcp.json project scope requires user approval via a trust dialog. Use the local scope instead — it loads automatically with no approval needed.

Use the Bash tool to run from PROJECT_ROOT:

claude mcp add -e KANBAN_DATA_DIR=PROJECT_ROOT/.kanban -e KANBAN_WEBSOCKET_HOST=127.0.0.1 kanban uv -- run --project SERVER_DIR python SERVER_DIR/mcp-kanban-server.py

Replace SERVER_DIR and PROJECT_ROOT with actual absolute paths. This writes to ~/.claude.json under the project's local scope and takes effect on next Claude Code restart.

Step 7: Update CLAUDE.md

Read PROJECT_ROOT/CLAUDE.md with the Read tool. If it does not contain ## Kanban Board, append the following using the Edit or Write tool (replace SERVER_DIR with actual path):

## Kanban Board

This project has a kanban board enabled. The `kanban` MCP server starts automatically with each Claude Code session.

**At session start:** call `kanban_status` to see the current board.
**After completing a task:** call `kanban_get_next_task` for the next item.

Key tools:
- `kanban_status` — board overview with task counts per column
- `add_feature` — add a task (id, title, description, priority, effort)
- `kanban_move_card` — advance: backlog → ready → progress → testing → done
- `kanban_get_next_task` — next highest-priority ready task
- `kanban_start_session` / `kanban_end_session` — track work sessions

Board data: `.kanban/kanban-progress.json`
Board UI: open SERVER_DIR/kanban-board.html in your browser (WebSocket on port 8765).

Step 8: Report to the user

Tell the user:

• Project: PROJECT_NAME (PROJECT_ROOT)
• Server: SERVER_DIR/mcp-kanban-server.py
• Board data: PROJECT_ROOT/.kanban/
• Board UI: SERVER_DIR/kanban-board.html
• They must restart Claude Code (or reload MCP servers) to activate the kanban MCP.