Skip to content
Skill

beads

by adrianco

AI Summary

Use Beads as the shared project task system. Local plans, scratch files, and personal memories are useful, but they are not the durable source of truth for project work. If that prints nothing, check whether the repository has an active Beads workspace: Use the CLI when shell access is available. I

Install

Copy this and paste it into Claude Code, Cursor, or any AI assistant:

I want to install the "beads" skill in my project.

Please run this command in my terminal:
# Install skill into your project
mkdir -p .claude/skills/beads && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/beads/SKILL.md "https://raw.githubusercontent.com/adrianco/retort/main/experiments/adrianco/experiment-5/runs/language=python_model=claude-opus-4-8_tooling=beads/rep1/.agents/skills/beads/SKILL.md"

Then restart Claude Code (or reload the window in Cursor) so the skill is picked up.

Description

Use when working in a repository that uses bd or Beads for durable project task tracking, issue dependencies, blocker management, multi-session handoff, or shared work memory. Trigger when the user asks to find ready work, claim or close tasks, create follow-up work, inspect blockers, recover project context, or choose between local planning and persistent project tracking.

Beads

Use Beads as the shared project task system. Local plans, scratch files, and personal memories are useful, but they are not the durable source of truth for project work.

First Step

Run: `bash bd prime ` If that prints nothing, check whether the repository has an active Beads workspace: `bash bd where `

Preferred Route

Use the bd CLI when shell access is available. It is the most compact and direct Beads interface.

Core CLI Workflow

• Find work: `bash bd ready bd list --status=open bd list --status=in_progress ` • Inspect before editing: `bash bd show <id> ` • Claim work atomically: `bash bd update <id> --claim ` • Create durable follow-up work when implementation reveals new tasks: `bash bd create "Short title" --description="Why this exists and what needs to be done" --type=task --priority=2 ` • Close completed work: `bash bd close <id> --reason="Completed" `

Discussion

0/2000
Loading comments...

Health Signals

MaintenanceCommitted 14d ago
● Active
Adoption100+ stars on GitHub
211 ★ · Growing
DocsREADME + description
Well-documented

GitHub Signals

Stars211
Forks12
Issues7
Updated14d ago
View on GitHub
Apache-2.0 License

My Fox Den

Community Rating

Sign in to rate this booster

Works With

Claude Code