Inspired by the Noisy Cricket — agent primitives that punch far above their weight.

_{Works with Claude Code + Antigravity — see compatibility}

Inspired by the iconic noisy cricket from Men in Black, Crickets is a tactical suite of agent primitives engineered to punch far above their weight. Skills, sub-agents, hooks — grouped into native plugins for Claude Code and Antigravity, generated from a single source of truth. The execution engine behind Agent M — the primitives you carry into any project to make the system work.

Agent M holds the phase-gated workflow, auto-recall, and on-disk state — the structural backend. Crickets holds everything that rides on top.

Latest: v3.0 — Native host plugins from a single source of truth (#40). The bespoke install.sh dispatcher is gone: customizations are authored once under src/<group>/, and scripts/generate.py emits committed native plugins under dist/ for both hosts, served via each host's marketplace. Install with one line, the marketplace, or a manual --plugin-dir — see the install how-to. The architecture + decisions live in ADR 0013 / 0014 / 0015. Release notes · Native-plugins HLD · CHANGELOG

What's inside

Four functional plugins (groups), seven primitives — each authored once in src/<group>/ and emitted as a native plugin per host.

Plugin	Primitives
developer (base)	kill-switch + steer + commit-on-stop hooks · evaluator sub-agent
github-ci	dependabot-fixer skill
pii	pii-scrubber skill
wiki	diataxis-evaluator sub-agent

• kill-switch — operator emergency halt: touch .harness/STOP → next PreToolUse halts the tool call (Claude Code; advisory-only on Antigravity — see Compatibility).
• steer — mid-run redirect: write .harness/STEER.md → injected into context, then archived.
• commit-on-stop — safety snapshot of a dirty tree to a side ref on Stop; never touches your branch.
• evaluator / diataxis-evaluator — read-only fresh-context graders (PASS / NEEDS_WORK).
• pii-scrubber / dependabot-fixer — the PII guardrail skill + the Dependabot-PR repair skill.

How it works

flowchart LR
    S[src/&lt;group&gt;/<br/>one source of truth<br/>kind · supported_hosts · requires]
    G[scripts/generate.py<br/>deterministic emit]
    CC[dist/claude-code/plugins/&lt;group&gt;]
    AG[dist/antigravity/plugins/&lt;group&gt;]
    S --> G
    G --> CC
    G --> AG

Loading

Author a primitive once under its group; the generator emits a native Claude Code plugin and a native Antigravity plugin per group, plus each host's marketplace manifest. The committed dist/ is the distribution surface, and a CI gate (generate.py check) fails if it drifts from src/. Per-host divergences (hook events, dependency handling, the snippet→rules/ gap) live in Per-Host-Paths + Compatibility.

Get started

Install the recommended set on whichever host(s) you have:

curl -fsSL https://raw.githubusercontent.com/alexherrero/crickets/main/bootstrap.sh | bash

Prefer the marketplace? One word from GitHub on Claude Code:

claude plugin marketplace add alexherrero/crickets
claude plugin install developer@crickets   # + github-ci@crickets, pii@crickets, wiki@crickets

All three install modes (one-liner / marketplace / manual --plugin-dir) per host: Install crickets plugins. Hacking on a plugin? Develop a crickets plugin locally.

PII guardrails (foundational)

This repo is public and holds personal customizations. Three enforcement layers protect against personal information leaking into commits:

1. Pre-push git hook (templates/hooks/pre-push) — copy it into a repo's .git/hooks/pre-push (cp templates/hooks/pre-push .git/hooks/ && chmod +x .git/hooks/pre-push). Runs check-no-pii.sh against every push; blocks non-zero. Mandatory enforcer for the crickets repo itself.
2. pii-scrubber plugin — agent-facing interactive layer. Scans the current diff, presents findings, offers redactions.
3. CI gate — check-no-pii.sh --all + the official gitleaks-action run on every push.

See CONTRIBUTING.md for the override protocol.

Repo structure

Top-level layout

crickets/
├── src/                # SOURCE OF TRUTH — src/<group>/ (group.yaml + skills/ agents/ hooks/ …)
├── dist/               # GENERATED native plugins (committed) — dist/<host>/plugins/<group>/
│   ├── claude-code/    #   + .claude-plugin/marketplace.json
│   └── antigravity/    #   + .agents/plugins/marketplace.json
├── .claude-plugin/     # repo-root marketplace pointer (one-word `marketplace add alexherrero/crickets`)
├── .agents/plugins/    # repo-root Antigravity marketplace pointer
├── scripts/            # generate.py (+ emit_*), lint_src.py, src_model.py, check-* gates, tests
├── bootstrap.sh        # one-line installer (curl | bash)
├── templates/          # scaffolding (e.g. hooks/pre-push)
├── wiki/               # Diátaxis docs (tutorials/ how-to/ reference/ explanation/)
├── AGENTS.md           # universal instructions for any AGENTS.md-aware host
└── CLAUDE.md           # Claude Code entry point — points back at AGENTS.md

Adding + developing customizations

• Tutorial 1 — Your first customization
• Develop a crickets plugin locally — the src/ → generate → dogfood loop
• Add a skill
• Use the evaluator · Use the base hooks
• Manifest Schema — primitive frontmatter + group.yaml

Status

Shipping v3.0 — native host plugins from a single source of truth (#40, launched). Four plugins / seven primitives prove the model on both hosts. The #36 skill relocations (design, diataxis-author, ship-release) + the full Developer-base composition + new bundles (Testing, Releasing, knowledge) are deferred to the v3.x catalog work (ADR 0015). One known host limitation: Antigravity runs plugin hooks observe/side-effect-only, so kill-switch/steer are Claude-only-effective there (ADR 0013). Ships in lockstep with Agent M. See CHANGELOG.md.

Contributing

Self-tested on every push by three per-OS workflows (Linux, Mac, Windows). Run the gates locally:

python3 scripts/lint_src.py                                 # validate src/ (group.yaml + frontmatter)
python3 scripts/generate.py check                           # committed dist/ in sync with src/
( cd scripts && python3 -m unittest discover -p 'test_*.py' )
bash scripts/check-syntax.sh
bash scripts/check-no-pii.sh --all
python3 scripts/check-wiki.py --strict

Full guidance in CONTRIBUTING.md.

License

MIT. See LICENSE.