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/swarm-ai-research/swarm/bv-dispatchgit clone --depth 1 https://github.com/swarm-ai-research/swarmWrote 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/swarm-ai-research/swarm/bv-dispatch)<a href="https://agentmods.dev/commands/swarm-ai-research/swarm/bv-dispatch"><img src="https://agentmods.dev/badge/commands/swarm-ai-research/swarm/bv-dispatch.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.1 | $0.00035 | $0.03639 |
| Opus 5 | $0.00017 | $0.01819 |
| Sonnet 5 | $0.00007 | $0.00728 |
| Haiku 4.5 | $0.00003 | $0.00364 |
Grade A, and why
bv-dispatch 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 today.
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.
How it starts
The opening of the file, as written. The whole thing — 243 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Mode
Arguments: $ARGUMENTS
- (no mode) — full dispatch: analyze, publish per-track ranked digests to the channel, stamp assignee-free rationale on shortlisted beads; push ASSIGN mail only for strategic beads (critical path, epics). Agents pull from their track's digest at claim time (beads-x3q7 — see "Pull-model delivery").
- plan — analysis and assignment table ONLY. Zero writes: no bead comments, no dependency edges, no mail. Safe to run anywhere.
- hygiene — run only the hygiene pass (step 5): cycles, orphans, stale
in-progress beads, missing edges. Propose fixes; apply only
bd dep add/ comment fixes the operator approves. - retro — grade the last dispatch: find rationale comments from previous runs
(they contain predicted unblock counts and metric values), compare predictions
against what actually closed/unblocked since, and report prediction accuracy.
This is how the dispatch policy learns whether its graph theory is working.
Also produce the MUD LEDGER (Foote & Yoder, Big Ball of Mud):
- Entropy ratio — beads closed by consolidation work (hygiene, sweeps, cleanup, test/CI fixes) vs new beads opened, since last retro. A rig that only expands is building a shantytown; report the ratio and trend.
- Rug audit — find results flagged "machinery validation only", mock-based numbers, or similar cordons in bead comments; verify nothing downstream cites them as real measurements. A rug becomes load-bearing silently.
- Shearing-layer check — fast-layer defaults (library constants, tool versions, config defaults) that have drifted against slow-layer commitments (prereg locks, frozen schemas, append-only principles). The pattern: grep frozen/locked/prereg commitments, compare each to the current default it constrains. Every hit is a naa8-class incident waiting.
- Orphan influx (Morgenthaler et al., "Searching for Build Debt", MTD'12: make the default the right thing) — of beads created since last retro, what fraction arrived with zero edges? The wrong default (edgeless creation) is a debt factory; sweeps and sessions should file with discovered-from/blocks edges at creation time. Report the fraction, name the worst offender source, and propose the default-side fix (creation-time nudge or template) rather than another cleanup pass.
- Gate execution audit (erdos-1038 lesson: verification-shaped ≠ verified;
docs/research/erdos-1038-swarm-lessons.md) — for each bead closed as
verified/tested since last retro, confirm the actual gate ran: test
output or run-folder path in a comment, CI run that executed (not just
a lint/regex proxy job), benchmark numbers from a real invocation.
Distinct from the rug audit: a rug is a cordoned mock cited as real; a
phantom gate is a verification step everyone believes ran and never
did. Where the bead carries a
WARDS:stamp, check the DONE against that stamp'snegative_speclist (python -m swarm.agentgit wards show <id>) rather than against the prose; a "flag pinned, behaviour not exercised" gate (Cantrip lesson 4) counts as phantom, one notch above "job never dispatched". Also audit blocked-bead reopenings: each must name the materially new mechanism that justified reopening (see analysis step 6).
Any text after the mode word is extra operator context — honor it.
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.
- today Changed · +21 lines a5b18d20de86
- 6d ago First seen · 222 lines · 35 tokens per session scan A 38b8531dcacf
bv-dispatch is a command published in the GitHub repository swarm-ai-research/swarm (41 stars, last pushed today), licensed MIT. It adds 35 tokens to every session and 3,639 once invoked, about $0.0002 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
tma1-peer
List recent sessions on this project by agent — peers (Codex, OpenClaw, Copilot CLI) or your own.
test
Run tests with intelligent package filtering and reporting.
eval-merge
Use the Read tool to load .skill-compass/{skill-name}/manifest.json. Verify.
video
Create a design based on video.
good
Write good creative & smart copy [GOOD].
speckit.git.validate
Validate current branch follows feature branch naming conventions.