Beads Viz

What it does

Beads Viz is an MCP App for visualising task graphs from Beads projects. Ask your AI agent "show me the task graph" and it renders a fully interactive DAG (directed acyclic graph) in a sandboxed iframe — colour-coded by phase, live-updating every 3 seconds, with dependency edges and a task detail drawer. All mutations still happen through chat; the viz is read-only.

Key features

• DAG view — ELK.js layered layout with phase-coloured nodes (9-colour palette), dependency edges, and click-to-expand task details
• List view — tasks grouped by status (Ready, In Progress, Blocked, Done)
• Stats dashboard — progress ring, phase completion bars, 7-day velocity chart
• Live polling — UI calls poll-tasks every 3 seconds for real-time updates without re-opening the widget
• WSL support — detailed setup instructions for Windows + WSL + Claude Desktop or VS Code

Installation

Requires Beads CLI (bd) installed and a Beads project.

Claude Desktop (macOS/Linux): Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "beads-viz": {
      "command": "npx",
      "args": ["-y", "beads-viz"],
      "cwd": "/path/to/your/beads-project"
    }
  }
}

VS Code Copilot: Add to VS Code settings.json:

{
  "github.copilot.chat.mcp.servers": {
    "beads-viz": {
      "command": "npx",
      "args": ["-y", "beads-viz"],
      "cwd": "${workspaceFolder}"
    }
  }
}

See README for Windows/WSL setup.

Supported hosts

Claude Desktop, VS Code Copilot