Gauntlith

beads

Unclaimed, from gastownhall

AI-supervised issue tracker for coding workflows. Manage tasks, discover work, and maintain context with simple CLI commands.

Plugin

View source at d76ade2

We couldn't check all of this version, so there's no install button.

Not fully checked28.7k starsd76ade282c19 · d76ade2 · pinned 12 Nov 2026
Permanent link

README at commit d76ade2 · shown without scripts

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.