kylesnowschwartz

Beads Lite — Productivity skill for Claude Code

Productivity community

Minimal dependency-aware task tracker for coding agents.

How to install Beads Lite

This entry records only its repository, not the path inside it, so there is no exact command to give. Open kylesnowschwartz/beads-lite and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Beads Lite does

Minimal dependency-aware task tracker for coding agents.

Alternatives in Productivity

Agentacct — See what your coding agents did and what it cost 665 ★
Dependency Update Workflow — Workflow command scaffold for dependency-update-workflow in JARVIS 355 ★
Cezar — Cezar is a parallel coding agents orchestrator 174 ★

README

beads-lite

Minimal dependency-aware task tracker for coding agents.

Install

# macOS/Linux
curl -sSL https://raw.githubusercontent.com/kylesnowschwartz/beads-lite/main/install.sh | sh

# or with Go
go install github.com/kylesnowschwartz/beads-lite/cmd/bl@latest

Usage

bl init                    # initialize in current directory
bl create "Fix login bug"  # create a task
bl ready                   # what can I work on?
bl close               # complete a task

Dependencies

bl create "Deploy"
bl create "Write tests"
bl update  --blocked-by   # deploy blocked until tests done
bl ready                                        # only "Write tests" shows
bl close 
bl ready                                        # now "Deploy" shows

CLI Reference

Usage: bl  [args]

Commands:
  init                  Initialize .beads-lite/ directory and database
  create         Create a new issue, prints ID
  list                  List all issues
  show              Show issue details
  update            Update an issue (including blockers)
  delete            Delete an issue permanently (requires --confirm)
  close             Close an issue
  ready                 List unblocked work
  export [file]         Export all issues to JSONL (stdout or file)
  import          Import issues from JSONL file
  onboard               Print Claude Code integration instructions
  version               Show version
  upgrade               Upgrade to latest release

List/Ready Flags:
  --json                Output as JSONL (one JSON object per line)
  --tree                Show dependency tree
  --priority       Filter by priority (0-4)
  --type        Filter by type (task, bug, feature, epic)

List-Only Flags:
  --status      Filter by status (open, in_progress, closed)
  --resolution  Filter by resolution (done, wontfix, duplicate)

Show Flags