{"id":32023574,"url":"https://github.com/steveyegge/beads","last_synced_at":"2026-03-03T08:49:51.114Z","repository":{"id":318735393,"uuid":"1074561042","full_name":"steveyegge/beads","owner":"steveyegge","description":"Beads - A memory upgrade for your coding agent","archived":false,"fork":false,"pushed_at":"2026-01-22T21:04:56.000Z","size":103554,"stargazers_count":12096,"open_issues_count":114,"forks_count":729,"subscribers_count":62,"default_branch":"main","last_synced_at":"2026-01-22T22:56:26.625Z","etag":null,"topics":["agents","claude-code","coding"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/steveyegge.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-10-12T03:09:46.000Z","updated_at":"2026-01-22T22:41:42.000Z","dependencies_parsed_at":"2025-10-28T19:18:35.460Z","dependency_job_id":"fff6be7b-43c1-40da-94f3-82cb4f358090","html_url":"https://github.com/steveyegge/beads","commit_stats":null,"previous_names":["steveyegge/beads"],"tags_count":81,"template":false,"template_full_name":null,"purl":"pkg:github/steveyegge/beads","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steveyegge%2Fbeads","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steveyegge%2Fbeads/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steveyegge%2Fbeads/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steveyegge%2Fbeads/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/steveyegge","download_url":"https://codeload.github.com/steveyegge/beads/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steveyegge%2Fbeads/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28769212,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-26T06:37:25.426Z","status":"ssl_error","status_checked_at":"2026-01-26T06:37:23.039Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents","claude-code","coding"],"created_at":"2025-10-16T09:52:39.108Z","updated_at":"2026-03-03T08:49:51.107Z","avatar_url":"https://github.com/steveyegge.png","language":"Go","funding_links":[],"categories":["Go","A01_文本生成_文本对话","Project \u0026 Knowledge Management","カテゴリ","Projects","🎭 Multi-Agent Orchestration","🗂️ Task, Memory \u0026 Workspace Management","Agent Orchestration","Agent Integration \u0026 Deployment Tools","Runtime"],"sub_categories":["大语言对话模型及数据","Other IDEs","🛠️ \u003ca name=\"developer-tools\"\u003e\u003c/a\u003e開発ツール","AI Agent Orchestration","Tool"],"readme":"# bd - Beads\n\n**Distributed, git-backed graph issue tracker for AI agents.**\n\n**Platforms:** macOS, Linux, Windows, FreeBSD\n\n[![License](https://img.shields.io/github/license/steveyegge/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/steveyegge/beads)](https://github.com/steveyegge/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\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## ⚡ Quick Start\n\n```bash\n# Install beads CLI (system-wide - don't clone this repo into your project)\ncurl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash\n\n# Initialize in YOUR project\ncd your-project\nbd init\n\n# Tell your agent\necho \"Use 'bd' for task tracking\" \u003e\u003e AGENTS.md\n```\n\n**Note:** Beads is a CLI tool you install once and use everywhere. You don't need to clone this repository into your project.\n\n## 🛠 Features\n\n* **[Dolt](https://github.com/dolthub/dolt)-Powered:** Version-controlled SQL database with cell-level merge, native branching, and built-in sync via Dolt remotes.\n* **Agent-Optimized:** JSON output, dependency tracking, and auto-ready task detection.\n* **Zero Conflict:** Hash-based IDs (`bd-a1b2`) prevent merge collisions in multi-agent/multi-branch workflows.\n* **Compaction:** Semantic \"memory decay\" summarizes old closed tasks to save context window.\n* **Messaging:** Message issue type with threading (`--thread`), ephemeral lifecycle, and mail delegation.\n* **Graph Links:** `relates_to`, `duplicates`, `supersedes`, and `replies_to` for knowledge graphs.\n\n## 📖 Essential Commands\n\n| Command | Action |\n| --- | --- |\n| `bd ready` | List tasks with no open blockers. |\n| `bd create \"Title\" -p 0` | Create a P0 task. |\n| `bd update \u003cid\u003e --claim` | Atomically claim a task (sets assignee + in_progress). |\n| `bd dep add \u003cchild\u003e \u003cparent\u003e` | Link tasks (blocks, related, parent-child). |\n| `bd show \u003cid\u003e` | View task details and audit trail. |\n\n## 🔗 Hierarchy \u0026 Workflow\n\nBeads supports hierarchical IDs for epics:\n\n* `bd-a3f8` (Epic)\n* `bd-a3f8.1` (Task)\n* `bd-a3f8.1.1` (Sub-task)\n\n**Stealth Mode:** Run `bd init --stealth` to use Beads locally without committing files to the main repo. Perfect for personal use on shared projects.\n\n**Contributor vs Maintainer:** When working on open-source projects:\n\n* **Contributors** (forked repos): Run `bd init --contributor` to route planning issues to a separate repo (e.g., `~/.beads-planning`). Keeps experimental work out of PRs.\n* **Maintainers** (write access): Beads auto-detects maintainer role via SSH URLs or HTTPS with credentials. Only need `git config beads.role maintainer` if using GitHub HTTPS without credentials but you have write access.\n\n## 📦 Installation\n\n* **npm:** `npm install -g @beads/bd`\n* **Homebrew:** `brew install beads`\n* **Go:** `go install github.com/steveyegge/beads/cmd/bd@latest`\n\n**Requirements:** Linux, FreeBSD, macOS, or Windows.\n\n## 🌐 Community Tools\n\nSee [docs/COMMUNITY_TOOLS.md](docs/COMMUNITY_TOOLS.md) for a curated list of community-built UIs, extensions, and integrations—including terminal interfaces, web UIs, editor extensions, and native apps.\n\n## 📝 Documentation\n\n* [Installing](docs/INSTALLING.md) | [Agent Workflow](AGENT_INSTRUCTIONS.md) | [Copilot Setup](docs/COPILOT_INTEGRATION.md) | [Articles](ARTICLES.md) | [Sync Branch Mode](docs/PROTECTED_BRANCHES.md) | [Troubleshooting](docs/TROUBLESHOOTING.md) | [FAQ](docs/FAQ.md)\n* [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/steveyegge/beads)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsteveyegge%2Fbeads","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsteveyegge%2Fbeads","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsteveyegge%2Fbeads/lists"}