[{"data":1,"prerenderedAt":4},["ShallowReactive",2],{"readme:beads":3},"\u003Ch1>bd - Beads\u003C\u002Fh1>\n\u003Cp>\u003Cstrong>Distributed graph issue tracker for AI agents, powered by \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fdolthub\u002Fdolt\" rel=\"nofollow ugc noopener\">Dolt\u003C\u002Fa>.\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cp>\u003Cstrong>Platforms:\u003C\u002Fstrong> macOS, Linux, Windows, FreeBSD\u003C\u002Fp>\n\u003Cp>\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fgastownhall\u002Fbeads\u002Fblob\u002FHEAD\u002FLICENSE\" rel=\"nofollow ugc noopener\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Fgastownhall\u002Fbeads\" alt=\"License\" \u002F>\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fgoreportcard.com\u002Freport\u002Fgithub.com\u002Fsteveyegge\u002Fbeads\" rel=\"nofollow ugc noopener\">\u003Cimg src=\"https:\u002F\u002Fgoreportcard.com\u002Fbadge\u002Fgithub.com\u002Fsteveyegge\u002Fbeads\" alt=\"Go Report Card\" \u002F>\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fgastownhall\u002Fbeads\u002Freleases\" rel=\"nofollow ugc noopener\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Fgastownhall\u002Fbeads\" alt=\"Release\" \u002F>\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@beads\u002Fbd\" rel=\"nofollow ugc noopener\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F@beads\u002Fbd\" alt=\"npm version\" \u002F>\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fpypi.org\u002Fproject\u002Fbeads-mcp\u002F\" rel=\"nofollow ugc noopener\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fpypi\u002Fv\u002Fbeads-mcp\" alt=\"PyPI\" \u002F>\u003C\u002Fa>\u003C\u002Fp>\n\u003Cp>\u003Cstrong>Docs:\u003C\u002Fstrong> \u003Ca href=\"https:\u002F\u002Fbeads.gascity.com\u002F\" rel=\"nofollow ugc noopener\">https:\u002F\u002Fbeads.gascity.com\u002F\u003C\u002Fa>\u003C\u002Fp>\n\u003Cp>Beads provides a persistent, structured memory for coding agents. It replaces messy markdown plans with a dependency-aware graph, allowing agents to handle long-horizon tasks without losing context.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-mermaid\">flowchart LR\n    create[\"bd create<br\u002F>new bead\"] --> depgraph[\"dependency<br\u002F>graph\"]\n    depgraph --> ready[\"bd ready<br\u002F>claimable work\"]\n    ready --> claim[\"bd update --claim<br\u002F>agent takes it\"]\n    claim --> close[\"bd close<br\u002F>work done\"]\n    close -->|blockers released| ready\n    depgraph <-->|\"bd dolt push \u002F pull\"| remote[(\"other machines<br\u002F>and agents\")]\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2>⚡ Quick Start\u003C\u002Fh2>\n\u003Cpre>\u003Ccode class=\"language-bash\"># Install beads CLI (system-wide - don't clone this repo into your project)\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fgastownhall\u002Fbeads\u002Fmain\u002Fscripts\u002Finstall.sh | bash\n\n# Initialize in YOUR project\ncd your-project\nbd init\n\n# Optional: refresh or install richer instructions for your agent\nbd setup codex    # Codex CLI - installs skill, AGENTS.md guidance, and hooks\nbd setup claude   # Claude Code - installs hooks\u002Fsettings\nbd setup factory  # Factory.ai Droid - creates\u002Fupdates AGENTS.md\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>\u003Cstrong>Note:\u003C\u002Fstrong> Beads is a CLI tool you install once and use everywhere. You don't need to clone this repository into your project.\u003C\u002Fp>\n\u003Cp>\u003Ccode>bd init\u003C\u002Fcode> creates or updates \u003Ccode>AGENTS.md\u003C\u002Fcode> by default so agents can discover the beads workflow, and also installs project Claude\u002FCodex integrations unless you pass \u003Ccode>--skip-agents\u003C\u002Fcode> or \u003Ccode>--stealth\u003C\u002Fcode>. Use \u003Ccode>bd setup --list\u003C\u002Fcode> to see supported integrations, including \u003Ccode>bd setup codex\u003C\u002Fcode>, \u003Ccode>bd setup factory\u003C\u002Fcode>, \u003Ccode>bd setup claude\u003C\u002Fcode>, \u003Ccode>bd setup mux\u003C\u002Fcode>, \u003Ccode>bd setup cursor\u003C\u002Fcode>, and more. See \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fgastownhall\u002Fbeads\u002Fblob\u002FHEAD\u002Fdocs\u002Fgetting-started\u002Fide-setup.md\" rel=\"nofollow ugc noopener\">Agent and IDE setup\u003C\u002Fa>.\u003C\u002Fp>\n\u003Cp>Manual copy-paste is only for unsupported agents, existing projects where you cannot rerun \u003Ccode>bd init\u003C\u002Fcode>\u002F\u003Ccode>bd setup\u003C\u002Fcode>, or custom instruction files. In those cases, run \u003Ccode>bd onboard\u003C\u002Fcode> and paste the printed snippet into the file your agent reads.\u003C\u002Fp>\n\u003Cp>If your agent is not covered by \u003Ccode>bd setup\u003C\u002Fcode>, add this minimal \u003Ccode>AGENTS.md\u003C\u002Fcode> section:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-markdown\">This project uses bd (beads) for issue tracking.\n\n- Run `bd prime` for workflow context and command guidance.\n- Use `bd ready`, `bd show <id>`, `bd update <id> --claim`, and `bd close <id>`.\n- Use `bd remember \"insight\"` for persistent project memory; do not create MEMORY.md files.\n- Do not use markdown TODO lists for task tracking.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2>🛠 Features\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Cstrong>\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fdolthub\u002Fdolt\" rel=\"nofollow ugc noopener\">Dolt\u003C\u002Fa>-Powered:\u003C\u002Fstrong> Version-controlled SQL database with cell-level merge, native branching, and built-in sync via Dolt remotes.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Agent-Optimized:\u003C\u002Fstrong> JSON output, dependency tracking, and auto-ready task detection.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Zero Conflict:\u003C\u002Fstrong> Hash-based IDs (\u003Ccode>bd-a1b2\u003C\u002Fcode>) prevent merge collisions in multi-agent\u002Fmulti-branch workflows.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Compaction:\u003C\u002Fstrong> Semantic \"memory decay\" summarizes old closed tasks to save context window.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Messaging:\u003C\u002Fstrong> Message issue type with threading (\u003Ccode>--thread\u003C\u002Fcode>), ephemeral lifecycle, and mail delegation.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Graph Links:\u003C\u002Fstrong> \u003Ccode>relates-to\u003C\u002Fcode>, \u003Ccode>duplicates\u003C\u002Fcode>, \u003Ccode>supersedes\u003C\u002Fcode>, and \u003Ccode>replies-to\u003C\u002Fcode> for knowledge graphs.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>📖 Essential Commands\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Command\u003C\u002Fth>\n\u003Cth>Action\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>bd ready\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>List tasks with no open blockers.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>bd create \"Title\" -p 0\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Create a P0 task.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>bd update <id> --claim\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Atomically claim a task (sets assignee + in_progress).\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>`bd dep a\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n",1785888993993]