beads-bridge

What problem does it solve?

This Skill eliminates the chaos of tracking projects across multiple repositories and different project management tools. It automates the aggregation of progress, generation of dependency diagrams, and detection of new work, freeing project managers and tech leads from manual updates and ensuring unified visibility across complex software initiatives.

Core Features & Use Cases

• Multi-Repository Progress Aggregation: Automatically combine task completion data from Beads-tracked issues across numerous repositories into a single, coherent view, saving hours of manual data compilation.
• Automated PM Tool Sync: Post real-time progress updates, including completion metrics and Mermaid diagrams, directly to GitHub Issues/Projects or Shortcut Stories, keeping stakeholders informed without manual effort.
• Visual Dependency Mapping: Generate clear Mermaid diagrams that illustrate task relationships and highlight blockers, making complex project structures easy to understand and proactively manage.
• Use Case: A tech lead overseeing a large feature spanning frontend, backend, and mobile teams (each in separate repos) can use this skill to get an aggregated status, identify cross-repo blockers, and automatically update the main GitHub issue without ever leaving Claude, ensuring consistent and up-to-date project visibility.

Quick Start

1. Install the plugin: /plugin install beads-bridge@wellmaintained
2. Authenticate with GitHub or Shortcut: beads-bridge auth github
3. Link your Beads epic to an external issue: bd update myproject-e1 --external-ref "github:your-org/your-repo#123"
4. Ask Claude for status: "What's the status of GitHub issue #123?"