beads-task-trackerlisted

# Beads Task Tracker ## Overview Beads is a git-versioned, dependency-aware issue tracker designed specifically for AI coding agents. It solves the "amnesia problem" where agents lose context between sessions by providing a persistent, queryable task database that agents can use to orient themselves, find ready work, and track dependencies across long-horizon projects. Use Beads when: - Working on projects with multiple interconnected tasks - Tasks span multiple agent sessions (>10 minutes) - Need to track what work is blocked vs. ready - Discovering new work during implementation that should be captured - Multiple agents or machines are working on the same codebase - Want to avoid the "markdown plan swamp" where plans become stale and disorganized ## Installation Check Before using Beads, verify the `bd` command is installed: ```bash bd version ``` If not installed, install via: ```bash curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash ``` **Post-installation PATH setup:** After installation, if `bd` is not found in your PATH, add the Go bin directory to your shell profile: For zsh (most macOS systems), add to `~/.zshrc`: ```bash export PATH="$PATH:$HOME/go/bin" ``` For bash, add to `~/.bashrc` or `~/.bash_profile`: ```bash export PATH="$PATH:$HOME/go/bin" ``` Then reload your shell: ```bash source ~/.zshrc # or source ~/.bashrc ``` Alternatively, you can use the full path `/Users/[username]/go/bin/bd` until PATH is c