beads/plugins/beads
2026-08-14 21:45:02 -07:00
..
.claude-plugin chore(release): forward-port v1.2.2 to main (version record, retracts, recovery guide, gate record) (#5782) 2026-08-14 21:45:02 -07:00
.codex-plugin chore(release): forward-port v1.2.2 to main (version record, retracts, recovery guide, gate record) (#5782) 2026-08-14 21:45:02 -07:00
.copilot-plugin chore(release): forward-port v1.2.2 to main (version record, retracts, recovery guide, gate record) (#5782) 2026-08-14 21:45:02 -07:00
agents fix(plugin): move claude agent out of shared codex dir to fix plugin install 2026-05-06 08:18:36 -04:00
skills/beads docs: caveat --parent label inheritance with size/effort labels (#4562) (#5123) 2026-07-31 01:44:50 -07:00
copilot_manifest.go feat: add Copilot CLI setup recipe (#3839) 2026-05-14 10:51:38 -07:00
README.md fix(codex): ship hook release safely 2026-05-27 13:19:41 -07:00

Beads Plugin

This is the shared Claude/Codex plugin package for Beads. Claude and Codex use separate manifest files, but they share the same skill tree.

Layout

  • .codex-plugin/plugin.json describes the Codex plugin.
  • .claude-plugin/plugin.json describes the Claude plugin.
  • skills/beads/ contains the plugin-owned Beads skill.
  • .codex-plugin/hooks/hooks.json contains Codex-only lifecycle hooks for startup and compaction-aware context refresh.
  • The Claude marketplace entry lives at .claude-plugin/marketplace.json.

Codex Hooks

The Codex plugin exposes native hooks through .codex-plugin/plugin.json, which points at .codex-plugin/hooks/hooks.json. With Codex 0.129.0+, /hooks shows these lifecycle handlers:

  • SessionStart runs bd codex-hook SessionStart for startup|resume|clear and injects full bd prime output.
  • PreCompact runs bd codex-hook PreCompact for manual|auto and warns if bd prime --memories-only cannot run.
  • PostCompact runs bd codex-hook PostCompact for manual|auto and records a one-shot refresh marker in the user cache/temp directory.
  • UserPromptSubmit runs bd codex-hook UserPromptSubmit and, when a refresh marker exists, injects full bd prime output once before clearing it.

If the plugin is not installed, bd setup codex writes an equivalent .codex/hooks.json fallback and enables [features].hooks = true.

Local Development

Claude Code uses .claude-plugin/marketplace.json, which points at this shared package root.