pi-beads

Pi coding agent integration for beads — a distributed graph issue tracker for AI agents.

What it does

• Auto-primes beads context at session start (injects bd prime output)
• 12 typed tools for issue management (no raw shell needed)
• Skill guide for workflow best practices
• /beads command for quick CLI access

Tools

Tool	Description
beads_ready	Find work ready to start (dependency-aware)
beads_list	List issues with filters
beads_show	Show issue details
beads_create	Create issues (task, bug, feature, epic, spike)
beads_update	Update/claim issues
beads_close	Close issues with reason
beads_dep	Manage dependencies (blocks, depends_on, relates_to)
beads_blocked	Show blocked issues
beads_remember	Store persistent memories across sessions
beads_stats	Project health overview
beads_discover	Scan codebase for TODOs/FIXMEs
beads_prime	Manually refresh beads context

Install

# Install from local path
pi install ~/workspace/pi-beads

# Or from git (after pushing)
pi install git:github.com/Lpaydat/pi-beads

Setup (per project)

bd init          # Initialize beads workspace
bd setup pi      # Inject beads workflow into AGENTS.md

Requirements

• bd CLI installed and on PATH (install beads)
• A beads-initialized project (bd init) in your working directory