Home

Inspired by the Noisy Cricket — compact, composable agent primitives.

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

Crickets is a set of small, composable agent primitives — skills, hooks, sub-agents, MCP servers, commands, and more — grouped into native plugins for Claude Code and Antigravity. They're what you add to a project to make Agent M (agentm) effective.

📚 Get started

Install the plugins alongside Agent M and point them at your project.

• Install crickets plugins — one-liner, marketplace, or manual --plugin-dir, on Claude Code or Antigravity. (Quick version in the repo README.)

🔧 What do you want to do?

What	Plugin	Example primitives
🪶 Maintain a wiki — Diátaxis shape, your house voice, doc-watching	wiki-maintenance	style-learning loop · wiki-watcher
🔁 Run a phase-gated dev process — interview → spec → plan → work → review → release	developer-workflows	/interview-me · /spec · evaluator · spawn a worker worktree · integrate a worker · instrument code · deprecate a surface · launch readiness gate · CI/CD pipeline authoring · record a decision
🔎 Review a change adversarially — any diff or PR, no /work cycle	code-review	code review · simplify a diff · in-flight decision review · security-review skill · testing-strategy skill
🛡️ Guard quality + secrets — control + recovery hooks, a PII scan on push	developer-safety	operator-control hooks · PII guardrail
📋 Plan & track a project — vault roadmaps + plans synthesized to a GitHub board	github-projects	sync a board · one-way synthesis
💰 Audit & watch token spend — per-turn cost breakdown + live status-line meter	token-audit + status-line-meter	/token-audit command · live ↑K↓K $0.xx [62%] badge
🧪 Keep testing discipline standing — skip-marker rule + 3-principle testing skill	testing-conventions	no-skip-tests rule · testing-conventions skill
🚢 Ship releases reliably — version-bump rule + pre-release checklist skill	releasing-conventions	version-bump-required rule · ship-release skill
📐 Author design docs + ADRs — /design pipeline and the ADR format skill	design-docs	adr skill · author a design · record a decision

📖 Look up a detail

For devs running the plugins:

• Compatibility — which hosts and OSes are supported, and the supported_hosts contract.
• Antigravity limitations — known host gaps and the trigger that closes each.
• Troubleshooting — symptom-first lookup when something stops working.

🏛️ How it's built

The structural component map — five components, each a folder under Architecture in the sidebar. → Browse the architecture

• Plugins — the shipped plugins and what each contains.
• Customization model — the primitive types and the enhances: soft-composition model.
• Build & distribution — src/ → generated dist/ native plugins, three install modes.
• Host adapters — the per-host surface mapping (Claude Code · Antigravity).
• Harness interface ↔ Agent M — the seam between this toolkit and the sibling harness.

🧩 Major designs

Architecture (Agent M) — the substrate crickets runs on. These are Agent M's; see its design docs rather than re-reading them here.

• Agent M memory — the MemoryVault store, the device-wide architecture, and the memory-OS unbundling. → Agent M design docs. Background: MemoryVault · memory evolution · device-wide · memory-OS.

Plugins (Crickets) — what each adds, in plain terms.

• Native host plugins (design) — author a primitive once; the generator emits native Claude Code and Antigravity plugins, installable three ways, with a CI gate that fails if dist/ drifts from src/.
• Developer plugin suite (design) — the phase-gated dev loop, the safety controls, and adversarial review, as three composable plugins joined by enhances:.
• Wiki maintenance (design) — a template-driven wiki maintainer that expands from Diátaxis toward your house voice via an operator-in-the-loop learning loop, plus the wiki-watcher.
• diataxis-author (design) — Diátaxis authoring and repair for any repo. (now an Agent M skill — see the Agent M design.)

💡 Why it works the way it does

Crickets is grounded in established practice and industry precedent — and it adapts that practice rather than following it to the letter. We take inspiration from Diátaxis for documentation (expanding from it toward a house voice, not applying it strictly), adversarial review for code, phase-gating for the dev loop, and deterministic gates ahead of LLM judgment.

• Purpose and scope — what the repo is for, and what it isn't.
• Why adversarial review — a reviewer primed to assume bugs finds real ones; a neutral "looks good" doesn't.
• Why deterministic gates run first — typecheck, lint, and tests gate before sycophantic LLM judgment.
• Why phase-gating — discrete plan → work → review → release gates beat freestyling the whole lifecycle.

📐 Architecture decisions

Every load-bearing call is recorded as an ADR — the "why X, and why not Y" trail, with re-audit triggers. → Browse all decisions

🤝 Want to contribute?

Building a plugin to contribute? Start with CONTRIBUTING, then the developer specs under Reference in the sidebar.