beads

{
  "aliases": [],
  "alternatives": [
    "GitHub Issues",
    "Linear",
    "Jira"
  ],
  "build_dependencies": [
    "go"
  ],
  "categories": [
    "agent-framework",
    "database-client",
    "development-tool"
  ],
  "caveats": null,
  "conflicts_with": [],
  "dependencies": [
    "dolt",
    "icu4c@78"
  ],
  "deprecated": 0,
  "deprecation_reason": null,
  "desc": "Memory upgrade for your coding agent",
  "disable_reason": null,
  "disabled": 0,
  "enrichment_fetched_at": "2026-06-20T23:35:48+00:00",
  "first_seen": "2026-06-20T23:34:18+00:00",
  "full_name": "beads",
  "github_default_branch": "main",
  "github_last_commit_at": "2026-06-20T22:29:29Z",
  "github_readme_excerpt": "# bd - Beads\n\n**Distributed graph issue tracker for AI agents, powered by [Dolt](https://github.com/dolthub/dolt).**\n\n**Platforms:** macOS, Linux, Windows, FreeBSD\n\n[![License](https://img.shields.io/github/license/gastownhall/beads)](LICENSE)\n[![Go Report Card](https://goreportcard.com/badge/github.com/steveyegge/beads)](https://goreportcard.com/report/github.com/steveyegge/beads)\n[![Release](https://img.shields.io/github/v/release/gastownhall/beads)](https://github.com/gastownhall/beads/releases)\n[![npm version](https://img.shields.io/npm/v/@beads/bd)](https://www.npmjs.com/package/@beads/bd)\n[![PyPI](https://img.shields.io/pypi/v/beads-mcp)](https://pypi.org/project/beads-mcp/)\n\n**Docs:** https://gastownhall.github.io/beads/\n\nBeads 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.\n\n## \u26a1 Quick Start\n\n```bash\n# Install beads CLI (system-wide - don\u0027t clone this repo into your project)\ncurl -fsSL https://raw.githubusercontent.com/gastownhall/beads/main/scripts/install.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/settings\nbd setup factory  # Factory.ai Droid - creates/updates AGENTS.md\n```\n\n**Note:** Beads is a CLI tool you install once and use everywhere. You don\u0027t need to clone this repository into your project.\n\n`bd init` creates or updates `AGENTS.md` by default so agents can discover the beads workflow, and also installs project Claude/Codex integrations unless you pass `--skip-agents` or `--stealth`. Use `bd setup --list` to see supported integrations, including `bd setup codex`, `bd setup factory`, `bd setup claude`, `bd setup mux`, `bd setup cursor`, and more. See [Agent and IDE setup](docs/SETUP.md).\n\nManual c",
  "github_repo": "steveyegge/beads",
  "github_stars": 24652,
  "github_topics": [
    "agents",
    "claude-code",
    "coding"
  ],
  "homepage": "https://github.com/steveyegge/beads",
  "homepage_og_description": null,
  "homepage_og_image": null,
  "homepage_title": null,
  "installs_30d": 2043,
  "installs_365d": 16938,
  "installs_90d": 8722,
  "keg_only": 0,
  "keg_only_reason": null,
  "last_seen": "2026-06-20T23:34:18+00:00",
  "license": "MIT",
  "llm_generated_at": "2026-06-20T23:48:09+00:00",
  "llm_model": "claude-haiku-4-5",
  "name": "beads",
  "oldnames": [],
  "one_liner": "Distributed graph-based issue tracker for AI coding agents, built in Go with Dolt backend for persistent structured memory.",
  "optional_dependencies": [],
  "rank_30d": 965,
  "rank_365d": 1147,
  "rank_90d": 866,
  "raw_hash": "455d0a4155234b61",
  "recommended_dependencies": [],
  "revision": 0,
  "ruby_source_path": "Formula/b/beads.rb",
  "tap": "homebrew/core",
  "test_dependencies": [],
  "uses_from_macos": [],
  "version_head": "HEAD",
  "version_stable": "1.0.5",
  "versioned_formulae": [],
  "why_use_this": "Beads provides persistent, context-aware memory for long-running AI agent workflows by replacing flat markdown task lists with a dependency-aware graph structure. It integrates with Claude Code, Codex, and other agent frameworks, and uses Dolt (Git-like version control for databases) to track changes over time. Useful if you\u0027re building or using AI-assisted coding pipelines that need to maintain coherent state across extended sessions."
}