Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add commands/gantisstorm/essentials-claude-code/beads-convertergit clone --depth 1 https://github.com/GantisStorm/essentials-claude-codeWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/commands/gantisstorm/essentials-claude-code/beads-converter)<a href="https://agentmods.dev/commands/gantisstorm/essentials-claude-code/beads-converter"><img src="https://agentmods.dev/badge/commands/gantisstorm/essentials-claude-code/beads-converter.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00023 | $0.00455 |
| Opus 5 | $0.00012 | $0.00228 |
| Sonnet 5 | $0.00005 | $0.00091 |
| Haiku 4.5 | $0.00002 | $0.00046 |
Grade A, and why
beads-converter scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
What it actually says
Beads Creator
Convert architectural plans into self-contained Beads issues. Works with /beads-loop, /beads-swarm, or RalphTUI - they're interchangeable.
Arguments
Plan path: .claude/plans/feature-3k7f2-plan.md
Instructions
Step 1: Validate bd
bd version &>/dev/null || echo "ERROR: Install bd first"
If bd not installed, report error and stop.
Step 2: Launch Agent
Launch background agent immediately with just the path:
Convert plan to beads: <plan-path>
REQUIRED Task tool parameters:
subagent_type: "essentials:beads-converter-default"
run_in_background: true
prompt: "Convert plan to beads: <plan-path>"
Output a status message like "Converting to beads..." and end your turn. The system wakes you when the agent finishes.
Step 3: Report Result
## Beads Created
Epic: <epic-id>
Tasks: <count>
## Next Steps
Review beads:
bd list -l ralph
bd show <epic-id>
Execute (choose one):
/beads-loop # Sequential (closes beads)
/beads-swarm --epic <epic-id> # Parallel (closes beads)
ralph-tui run --tracker beads --epic <epic-id> # Classic Ralph TUI executor
Error Handling
| Scenario | Action |
|---|---|
| bd not installed | "Install bd: https://github.com/anthropics/beads" |
| bd not initialized | "Run: bd init" |
| Path not found | Report error |
Example Usage
/beads-converter .claude/plans/add-auth-3k7f2-plan.md
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 4d ago First seen · 77 lines · 23 tokens per session scan A aa83d0c08c21
beads-converter is a command published in the GitHub repository GantisStorm/essentials-claude-code (91 stars, last pushed 6mo ago), licensed Unlicense. It adds 23 tokens to every session and 455 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other commands, from other repositories
debug
Systematic debugging with hypotheses and evidence gathering.
whats-next
Show current project status and suggest next steps.
review
Run a Codex code review of your working tree or a branch (read-only).
explore
Fast codebase exploration with Antigravity's agy CLI (Gemini 3.7 Flash, read-only). EXPERIMENTAL.
specmanager-build
Build one phase of a SpecManager feature's plan via the builder subagent. Stops at the phase boundary; never advances.
execute
Execute the next available tracked task with TDD, pre-commit validation, PR creation, AI code review, and issue tracker bridge sync.