{"id":51231225,"url":"https://github.com/jeremylongshore/beads-dolt","last_synced_at":"2026-06-28T16:31:00.457Z","repository":{"id":366200635,"uuid":"1275254284","full_name":"jeremylongshore/beads-dolt","owner":"jeremylongshore","description":"A Dolt/DoltHub-aware Claude Code plugin for the beads (bd) task tracker: skill + 5 expert agents + a wired dolthub/dolt-mcp server. Builds on beads and Dolt/DoltHub.","archived":false,"fork":false,"pushed_at":"2026-06-20T17:16:09.000Z","size":62,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-20T19:10:11.427Z","etag":null,"topics":["beads","claude-code","claude-code-plugin","dolt","dolthub","mcp","sql","task-tracking"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jeremylongshore.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-20T13:01:15.000Z","updated_at":"2026-06-20T17:16:12.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/jeremylongshore/beads-dolt","commit_stats":null,"previous_names":["jeremylongshore/beads-dolt"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/jeremylongshore/beads-dolt","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeremylongshore%2Fbeads-dolt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeremylongshore%2Fbeads-dolt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeremylongshore%2Fbeads-dolt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeremylongshore%2Fbeads-dolt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jeremylongshore","download_url":"https://codeload.github.com/jeremylongshore/beads-dolt/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeremylongshore%2Fbeads-dolt/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34896652,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-28T02:00:05.809Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["beads","claude-code","claude-code-plugin","dolt","dolthub","mcp","sql","task-tracking"],"created_at":"2026-06-28T16:30:59.802Z","updated_at":"2026-06-28T16:31:00.444Z","avatar_url":"https://github.com/jeremylongshore.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# beads-dolt\n\nA Dolt/DoltHub-aware Claude Code plugin for the [beads](https://github.com/gastownhall/beads) (`bd`) task tracker.\n\nIt packages, in one plugin:\n\n- **A skill** (`/beads-dolt`) — the beads workflow upgraded to understand bd's Dolt backend: it surfaces the common \"my beads aren't visible in DoltHub\" root cause (no remote configured), the `bd dolt remote add` + push fix, the JSONL throttle/export model, and the rapid-write-race safe pattern — and dispatches the agents below.\n- **Five expert agents** — grounded in a reverse-engineered, source-cited reference of bd's Dolt internals (`references/beads-dolt-internals.md`):\n  - `dolt-sync-advisor` — DoltHub remotes, `bd dolt push`/`pull`, backup vs push, federation, drift.\n  - `bead-epic-auditor` — subtree/epic-closure audits (which epics have all children closed).\n  - `bead-dependency-mapper` — dependency graphs, cycles, critical path (SQL via the Dolt MCP).\n  - `bead-recovery-specialist` — rapid-write-race recovery, embedded↔server mode migration, dolt-server incidents.\n  - `beads-guru` — general bd/Dolt expertise and the three-layer mirror discipline.\n- **A wired Dolt MCP server** (`.mcp.json`) — the official [`dolthub/dolt-mcp`](https://github.com/dolthub/dolt-mcp) server (45 tools) fronting your local `dolt sql-server` over the MySQL protocol, so the SQL-capable agents can query the bead graph directly.\n\n## Built on\n\nThis plugin builds on, and credits, two open-source projects:\n\n- **[beads](https://github.com/gastownhall/beads)** — the `bd` task tracker (the data this plugin operates on).\n- **[Dolt](https://github.com/dolthub/dolt) / [DoltHub](https://www.dolthub.com)** — the version-controlled SQL database that is bd's backend, and the cloud host that makes a bead graph shareable. The MCP server is [`dolthub/dolt-mcp`](https://github.com/dolthub/dolt-mcp).\n\n## Prerequisites\n\n- [`bd`](https://github.com/gastownhall/beads) ≥ 1.0.4 with a Dolt-backed workspace.\n- The Dolt MCP server binary on `PATH`. Install it one of these ways:\n  ```bash\n  go install github.com/dolthub/dolt-mcp/mcp/cmd/dolt-mcp-server@latest   # native (Go)\n  # or\n  docker pull dolthub/dolt-mcp:latest                                      # container\n  # or grab a release binary from https://github.com/dolthub/dolt-mcp/releases\n  ```\n\n## Configuration\n\nThe MCP connection is environment-overridable (defaults target the shared `bd dolt --global` server on `:3308`):\n\n| Env var | Default | Notes |\n|---|---|---|\n| `DOLT_HOST` | `127.0.0.1` | bd's dolt server is loopback-bound. |\n| `DOLT_PORT` | `3308` | The shared-server port. For a per-project server, get the port from `bd dolt show`. |\n| `DOLT_USER` | `root` | bd's default. |\n| `DOLT_DATABASE` | `beads` | Your workspace's database name (see `bd dolt show`). |\n| `DOLT_PASSWORD` | _(empty)_ | bd's server is unauthenticated by default. |\n\n## How it was evaluated\n\nThis plugin was run end-to-end through the [Intent Eval Platform](https://github.com/jeremylongshore/intent-eval-lab) — deterministic gates → behavioral eval (real model) → kernel-validated Evidence Bundle → ship/no-ship decision. The full evidence and the ship/no-ship decision are recorded in [`DOGFOOD.md`](./DOGFOOD.md); the methodology write-up is the platform's [case study](https://github.com/jeremylongshore/intent-eval-lab/blob/main/000-docs/088-RR-LAND-beads-dolt-external-adopter-convergence-proof-2026-06-20.md). (The eval even surfaced — and we fixed — a bug in the platform's own evidence emitter.)\n\n## License\n\nApache-2.0. See [LICENSE](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeremylongshore%2Fbeads-dolt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjeremylongshore%2Fbeads-dolt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeremylongshore%2Fbeads-dolt/lists"}