{"id":51223033,"url":"https://github.com/DollarDill/beads-superpowers","last_synced_at":"2026-07-09T07:00:29.343Z","repository":{"id":349504986,"uuid":"1202538987","full_name":"DollarDill/beads-superpowers","owner":"DollarDill","description":"Superpowers \u0026 Beads task memory for AI coding agents - supports Claude Code, Codex, OpenCode, Cursor, Gemini CLI, GitHub Copilot CLI, Kimi Code, Antigravity, Factory Droid, and Pi.","archived":false,"fork":false,"pushed_at":"2026-07-08T02:15:23.000Z","size":69036,"stargazers_count":16,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-07-08T03:21:43.229Z","etag":null,"topics":["ai-agent","ai-coding-agent","beads","brainstorming","claude-code","claude-code-plugin","code-review","codex","cursor","developer-tools","gemini-cli","github-copilot","issue-tracker","kimi","opencode","pi","superpowers","systematic-debugging","task-tracking","tdd"],"latest_commit_sha":null,"homepage":"https://dollardill.github.io/beads-superpowers/","language":"Shell","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/DollarDill.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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},"funding":{"buy_me_a_coffee":"dollardill"}},"created_at":"2026-04-06T06:02:42.000Z","updated_at":"2026-07-08T02:15:28.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/DollarDill/beads-superpowers","commit_stats":null,"previous_names":["dollardill/beads-superpowers"],"tags_count":20,"template":false,"template_full_name":null,"purl":"pkg:github/DollarDill/beads-superpowers","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DollarDill%2Fbeads-superpowers","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DollarDill%2Fbeads-superpowers/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DollarDill%2Fbeads-superpowers/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DollarDill%2Fbeads-superpowers/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DollarDill","download_url":"https://codeload.github.com/DollarDill/beads-superpowers/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DollarDill%2Fbeads-superpowers/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35290235,"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-07-09T02:00:07.329Z","response_time":57,"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":["ai-agent","ai-coding-agent","beads","brainstorming","claude-code","claude-code-plugin","code-review","codex","cursor","developer-tools","gemini-cli","github-copilot","issue-tracker","kimi","opencode","pi","superpowers","systematic-debugging","task-tracking","tdd"],"created_at":"2026-06-28T09:00:31.116Z","updated_at":"2026-07-09T07:00:29.337Z","avatar_url":"https://github.com/DollarDill.png","language":"Shell","funding_links":["https://buymeacoffee.com/dollardill"],"categories":["Source Catalog"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003cstrong\u003eEnglish\u003c/strong\u003e · \u003ca href=\"README.zh-CN.md\"\u003e中文\u003c/a\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/banner.svg\" alt=\"beads-superpowers — Process discipline and persistent memory for AI coding agents\" width=\"100%\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg alt=\"License: MIT\" src=\"https://img.shields.io/badge/license-MIT-blue.svg\"\u003e\u003c/a\u003e\n  \u003ca href=\".claude-plugin/plugin.json\"\u003e\u003cimg alt=\"Plugin version\" src=\"https://img.shields.io/badge/plugin-v0.10.0-4f46e5.svg\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/DollarDill/beads-superpowers/stargazers\"\u003e\u003cimg alt=\"GitHub stars\" src=\"https://img.shields.io/github/stars/DollarDill/beads-superpowers?style=social\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\nA plugin for Claude Code, Codex, OpenCode, and 6 more AI coding agents that makes your agent write tests before code, debug systematically instead of guessing, and remember what it worked on yesterday. Composable skills enforce the practices; a Dolt-backed issue tracker keeps context across sessions.\n\n## How it works\n\nWhen you start a task, the agent runs **brainstorming** to nail down requirements before touching code, then **writing-plans** to break the work into `bd`-tracked steps that survive session restarts. During implementation it follows **test-driven-development** (failing test first, always) and can fan out to parallel subagents via **subagent-driven-development** — each agent working in its own git worktree. `bd` stores every task, decision, and note in a local Dolt database, so the agent picks up exactly where it left off next session without relying on chat history.\n\nUnderneath all of it is a production-grade standard: the agent treats every task as if real users depend on it, so it won't quietly cut a corner, drop a requirement, or weaken a security control to move faster.\n\n## What's Inside\n\n### Testing\n\n| Skill | What it does |\n|-------|-------------|\n| `test-driven-development` | RED-GREEN-REFACTOR loop — Iron Law: no implementation without a failing test |\n| `verification-before-completion` | Evidence before claims — requires proof before marking anything done |\n\n### Debugging\n\n| Skill | What it does |\n|-------|-------------|\n| `systematic-debugging` | 4-phase root-cause analysis before proposing any fix |\n\n### Collaboration\n\n| Skill | What it does |\n|-------|-------------|\n| `requesting-code-review` | Dispatches a code-reviewer subagent with structured criteria |\n| `receiving-code-review` | Anti-sycophancy reception — evaluates each finding on its merits |\n| `subagent-driven-development` | Fresh agent per task with spec + quality review; parallel batch mode for independent tasks |\n| `dispatching-parallel-agents` | Fan-out to 2+ independent agents without shared state |\n\n### Project management\n\n| Skill | What it does |\n|-------|-------------|\n| `brainstorming` | Socratic design session before any code — produces a spec bead |\n| `stress-test` | Adversarial interrogation of plans with recommended answers |\n| `writing-plans` | Breaks work into bite-sized tasks, each tracked as a `bd` bead |\n| `executing-plans` | Batch plan execution in a single session |\n| `using-git-worktrees` | Isolated development branches per task |\n| `finishing-a-development-branch` | Merge/PR flow + Land the Plane (close beads, push) |\n| `document-release` | Post-ship doc audit — keeps README, CHANGELOG, and ARCHITECTURE in sync |\n| `project-init` | Beads/Dolt DB setup, bootstrap, and recovery |\n| `getting-up-to-speed` | Session orientation — reads the latest session-handoff doc, loads `bd` context, and produces a current-state summary |\n| `memory-curator` | Session-close/on-demand memory consolidation — deduplicates and prunes the `bd` memory store |\n| `session-handoff` | Human-invoked — writes a grounded handoff doc + continuation memory to resume in-progress work |\n| `research-driven-development` | Parallel research agents → synthesized knowledge-base document |\n| `write-documentation` | Human-quality prose — 14-rule writing system with context-first drafting |\n\n### Meta\n\n| Skill | What it does |\n|-------|-------------|\n| `using-superpowers` | Bootstrap — injected at session start, routes to the right skill |\n| `writing-skills` | Meta-skill for creating or modifying skills in this plugin |\n\n## Docs\n\n**[dollardill.github.io/beads-superpowers](https://dollardill.github.io/beads-superpowers/)** — getting started, methodology, skills reference, example workflow, and tips.\n\n## Quickstart\n\nThe fastest path — Claude Code with native plugin install:\n\n```bash\nbrew install beads                    # 1. Install bd (requires beads v1.1.0+)\n# From your shell:\nclaude plugin marketplace add DollarDill/beads-superpowers\nclaude plugin install beads-superpowers@beads-superpowers-marketplace\n# Or, inside a Claude Code session:\n# /plugin marketplace add DollarDill/beads-superpowers\n# /plugin install beads-superpowers@beads-superpowers-marketplace\n# Then in your project directory:\nbd init                               # 2. Bootstrap the Dolt database for this project\n```\n\nStart a new Claude Code session and type \"where are we\" — the agent will load your `bd` context and pick up where you left off.\n\nUsing a different agent? See [Installation](#installation) for native install on Codex, OpenCode, Cursor, GitHub Copilot CLI, Kimi Code, Antigravity, Factory Droid, and Pi.\n\n## Prerequisites\n\n**Install `bd` before the plugin.** Its hooks call `bd` on every session start; without it they fail silently and you lose persistent memory. The Quickstart above uses Homebrew, or `npm install -g @beads/bd` on any platform. Verify with `bd version`.\n\n**Note:** Native plugin install (Tier 1) installs skills and hooks, but not `bd init` — run that yourself per project.\n\n## Installation\n\n\u003e **⚠️ Coexistence warning:** Do not install alongside [obra/superpowers](https://github.com/obra/superpowers). Skill names collide — pick one or the other.\n\n### Tier 1 — Verified\n\nThese paths are tested end-to-end. Prefer them.\n\n#### Claude Code\n\n```bash\nclaude plugin marketplace add DollarDill/beads-superpowers\nclaude plugin install beads-superpowers@beads-superpowers-marketplace\n```\n\nOr as slash commands inside a Claude Code session: `/plugin marketplace add DollarDill/beads-superpowers` then `/plugin install beads-superpowers@beads-superpowers-marketplace`.\n\n#### Codex CLI\n\n```bash\ncodex plugin marketplace add DollarDill/beads-superpowers\ncodex plugin install beads-superpowers@beads-superpowers-marketplace\n```\n\nAfter installing, enable hooks in `~/.codex/config.toml`:\n\n```toml\n[features]\ncodex_hooks = true\n```\n\nTo get the SessionStart hook under Codex, use the scripted installer (`install.sh`) rather than the plugin channel — the plugin channel installs the skills but does not wire the hook.\n\n#### OpenCode\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/DollarDill/beads-superpowers/main/install.sh | bash\n```\n\nThe installer detects OpenCode and copies skills to `~/.config/opencode/skills/` and the TypeScript plugin to `~/.config/opencode/plugins/` (active automatically).\n\n### Tier 2 — Best-effort\n\nConfig validated; not E2E-tested by us. Use with that in mind.\n\n#### Cursor\n\n```text\n/add-plugin beads-superpowers\n```\n\nRun this command inside Cursor Agent. Update via the Marketplace UI.\n\n#### GitHub Copilot CLI\n\n```bash\ncopilot plugin marketplace add DollarDill/beads-superpowers\ncopilot plugin install beads-superpowers@beads-superpowers-marketplace\n```\n\nUpdate:\n\n```bash\ncopilot plugin update beads-superpowers\n```\n\nNote: rides the Claude-plugin fallback (skills + session-start via the shared `hooks/hooks.json`), the same mechanism upstream ships; requires Copilot CLI v1.0.11+ for session-start context injection.\n\n#### Kimi Code\n\n```text\n/plugins install https://github.com/DollarDill/beads-superpowers\n```\n\nRun `/new` after install to start a fresh session with the plugin active.\n\n#### Antigravity\n\n```bash\nagy plugin install https://github.com/DollarDill/beads-superpowers\n```\n\nNote: reuses the Claude plugin manifest — the same mechanism upstream verified.\n\n#### Factory Droid\n\n```bash\ndroid plugin marketplace add https://github.com/DollarDill/beads-superpowers\ndroid plugin install beads-superpowers@beads-superpowers-marketplace\n```\n\nNote: reuses the Claude plugin manifest — the same mechanism upstream verified.\n\n#### Pi\n\n```bash\npi install git:github.com/DollarDill/beads-superpowers\n```\n\n#### Universal fallback (npx)\n\n\u003e **Updating from ≤0.8.2:** earlier versions registered a per-prompt reminder hook that no longer ships. If your `~/.claude/settings.json` still references `superpowers-reminder.sh`, back it up, then remove the entry:\n\u003e\n\u003e ```bash\n\u003e cp ~/.claude/settings.json ~/.claude/settings.json.bak\n\u003e python3 -c \"import json,os;p=os.path.expanduser('~/.claude/settings.json');d=json.load(open(p));H=d.get('hooks',{});U=H.get('UserPromptSubmit',[]);[m.update({'hooks':[h for h in m.get('hooks',[]) if 'superpowers-reminder' not in h.get('command','')]}) for m in U];U=[m for m in U if m.get('hooks')];(H.update({'UserPromptSubmit':U}) if U else H.pop('UserPromptSubmit',None));json.dump(d,open(p,'w'),indent=2)\"\n\u003e ```\n\nInstalls the skills only — no hooks. Skill activation relies on your harness's native skill discovery.\n\n```bash\nnpx skills add DollarDill/beads-superpowers -g --copy -y\n```\n\nFor the full experience (session-start injection of skill context + a composed beads context), use the plugin install (Claude Code / Codex / OpenCode above) or the install script. To get beads context on an npx install, run `bd setup claude` (beads' own hook installer).\n\n### Alternative: scripted install (`curl | bash`)\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/DollarDill/beads-superpowers/main/install.sh | bash\n```\n\nThe script's role is broader than just copying files. Use it when you need any of:\n\n- **Beads/Dolt bootstrap** — auto-detects whether `bd` is installed and guides setup\n- **Hook registration** — writes the SessionStart entry to settings.json (required when using the install-script path)\n- **`yegge.md` orchestrator** — optional add-on: installed only when you pass `--with-yegge`. The flag forces the scripted tarball/git install tier (the plugin and npx tiers are skipped for that run), so it can't be combined with a plugin-managed install in one command\n- **Version pinning** — `--version X.Y.Z` for reproducible CI installs\n- **CI environments** — use `--yes --skip-checksum` for unattended runs\n\nSupports: `--yes` (skip prompts), `--version X.Y.Z`, `--with-yegge`, `--dry-run`, `--skip-checksum`, `--uninstall`.\n\n## Built on\n\n- **[Superpowers](https://github.com/obra/superpowers)** by Jesse Vincent — the skill system and development practices\n- **[Beads](https://github.com/gastownhall/beads)** by Steve Yegge — persistent issue tracking with cross-session memory\n\n## Contributing\n\nSee [`CONTRIBUTING.md`](CONTRIBUTING.md). Ideas welcome in **[Discussions](https://github.com/DollarDill/beads-superpowers/discussions/27)**.\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDollarDill%2Fbeads-superpowers","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FDollarDill%2Fbeads-superpowers","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDollarDill%2Fbeads-superpowers/lists"}