Beadmaster

Beadmaster

**Sync task management systems for AI coding agents**

Beadmaster bridges [Task Master](https://github.com/eyaltoledano/claude-task-master) and [Beads](https://github.com/steveyegge/beads), letting you use Task Master for AI-powered planning and Beads for execution tracking.

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│ Task Master │ ←──→│ Beadmaster  │←──→ │   Beads     │
│  (planning) │     │   (sync)    │     │ (execution) │
└─────────────┘     └─────────────┘     └─────────────┘

Why?

Tool	Strength	Weakness
Task Master	AI PRD parsing, complexity analysis	No dependency graphs
Beads	Dependencies, discovered-from links	No AI task generation

**Beadmaster** gives you both: use Task Master's AI to break down PRDs, then track execution in Beads with full dependency awareness.

Installation

npm install -g beadmaster
# or
npx beadmaster

Quick Start

# Initialize in your project (creates .beadmaster/, optionally updates docs)
beadmaster init              # Basic setup
beadmaster init --docs       # Also append instructions to AGENTS.md

# Check what's available
beadmaster status

# One-time import from Task Master → Beads
beadmaster import --dry-run  # Preview
beadmaster import            # Execute

# Ongoing bidirectional sync
beadmaster sync --dry-run    # Preview
beadmaster sync              # Execute

# Manual linking
beadmaster link 85 shadow-work-abc
beadmaster unlink 85

# List all links
beadmaster links

Commands

`beadmaster init`

Initialize Beadmaster in your project. Creates `.beadmaster/` directory and optionally appends usage instructions to your documentation.

beadmaster init              # Basic setup
beadmaster init --docs       # Also append to AGENTS.md
beadmaster init --claude     # Append to CLAUDE.md instead
beadmaster init --docs -f    # Force overwrite existing section

**Output:**

Initializi