Superloopy plugin
Superloopy runs a task in a loop and closes it only with real evidence: a plugin for Codex, Claude Code and Antigravity.
- 114 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The Stop hook keeps the session going and continues agent work without a new prompt until the loop ends.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/superloopyDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The Stop hook keeps the session going and continues agent work without a new prompt until the loop ends.
This is third-party code. Review the repository files before installing.
What it does
A set of skills, hooks and optional subagents that forces an agent to back "done" with artifacts. Type `loopy add the payments module`: the agent plans, does the work and leaves proof in `.superloopy/evidence/`. For criteria with a command, Superloopy re-runs them at completion, so a stale or fabricated pass cannot get through. Skills are invoked by keyword: `superloopy-loop` for a full loop, `superloopy-doctor` for install diagnostics, `superloopy-research` for research with graded sources, `superloopy-backend` for database work. The optional subagent crew is forge, sentinel, probe, arbiter, assayer and pathfinder. A Stop hook keeps the session going until the loop is finished.
Who it is for. Developers on Codex, Claude Code and Antigravity who need agents not to report success without a verifiable result.
Good fit when
- A big task needs a plan and a proof file for every step.
- The agent tends to say "done" without running tests.
- You need research with dated sources and a claim ledger.
- A plugin install across several agents must be checked with diagnostics.
Not a fit when
- The task is small and a loop with proof would only slow it down.
- Criteria cannot be expressed as a command or an artifact.
- You need an agent without a Stop hook that keeps the session going.
Example request
loopy add the payments module and leave proof in `.superloopy/evidence/` for each criterion.Limitations
The strong guarantee covers command-backed criteria, while manual criteria rest on an artifact plus auditor or human judgment. Node.js 22 or newer is required. The Stop hook continues a session only after `loopy` and until you send a plain prompt. `SUPERLOOPY_STOP_HOOK=on` enables the hook for every session with unfinished work and `off` disables it. Each host uses its own plugin commands.
How to disable. Switch the Stop hook off with `SUPERLOOPY_STOP_HOOK=off` or remove the plugin with the host plugin commands. Delete the `.superloopy/` folder in the project by hand.
FAQ
How do I install Superloopy?
Run `npx superloopy@latest`. It finds `claude`, `codex`, `agy` and `omp` on `PATH`, asks before each install and uses that host own plugin commands.
How do I start a loop?
Begin the request with `loopy`, for example `loopy add the payments module`. The agent plans and leaves proof.
What is checked at completion?
Command-backed criteria are re-run in process. If the result does not reproduce, the loop does not close.
How do I disable the Stop hook?
Set `SUPERLOOPY_STOP_HOOK=off`.
What does superloopy-doctor do?
It produces a read-only report on wrapper, cache, version and hooks and prints a repair command to run only if approved.
Discussion
No questions or reviews yet.
Related
PluginsA 33-skill plugin with gates: question the request, verify facts against sources, test first, review by a second model
A cleanup skill for agent-written code: finds surplus tests, self-checks and fallbacks and deletes them, keeping behavior
A Claude Code and Codex plugin with skills for code research, tests, refactoring and independent review of finished changes
A Claude Code and Codex plugin that finds task code by symbols and Git history, builds context and picks a specialist role.
Three Claude Code plugins: the savvy-flow orchestrator with tiered subagents and two mods for a progress panel and a cache timer
Claude Code kit with eight phase agents, 21 skills and hooks that keep the agent inside set limits.
README in short
The README shows starting with the `loopy` phrase, explains the strong guarantee, lists skills with their artifacts and the subagent crew and covers installation on Codex, Claude Code and Antigravity. Translations in five languages are included.