Skip to content
TakoAPI
Back to skills

beads

by rnijhara

Marketing & Sales
1.7kDownloads reported by clawskills.sh
1Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Git-backed issue tracker for AI agents.

Description

What This Skill Does

Distributed, git-backed issue tracker for AI agents. Stores tasks as JSONL in .beads/ with a dependency-aware graph that replaces markdown plans. Supports multi-agent coordination, hierarchical epics, and machine-readable output via --json flags.

Unlike markdown task lists, beads lets agents query unblocked work directly with structured JSON and enforces dependency ordering automatically.

When to Use It

  • Tracking multi-step agent tasks with blocking dependencies
  • Coordinating parallel work across multiple AI agents on one project
  • Querying the next unblocked task in a project work queue
  • Organizing large projects into epics with nested subtasks
  • Persisting task state across sessions via git commits

Example Workflow

INPUT

User asks: Plan and track a multi-step coding project with an AI agent

AGENT
  1. 1

    Run bd init --quiet to initialize the task database in .beads/

  2. 2

    Run bd create for each task with priorities and dependency links using --json

  3. 3

    Run bd ready --json to get the current unblocked work queue

  4. 4

    Run bd update <id> --status in_progress --assignee agent-1 to claim a task

  5. 5

    Run bd close <id> --reason "Done" then bd sync to commit and flush changes to git

OUTPUT

Tasks stored in .beads/ as a dependency graph, committed to git, with remaining work surfaced for agent handoff

Requirements

  • bd CLI (install via brew install beads or npm install -g @beads/bd)

Installation

clawhub install rnijhara/beads

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links