โ†— Evidence-first loop engineering

Done means proven.
Not just said.

Type loopy <task> โ€” an agent does the work, proves every piece with a real artifact, and only then says it's done. Like Luffy reaching the goal: it stretches as far as it takes.

$ loopy fix the failing login test and prove it
โ€บ plan โ€ฆโ€ฆโ€ฆ 3 steps
โ€บ proof โ€ฆโ€ฆ .superloopy/evidence/login-test.txt
โ€บ gate โ€ฆโ€ฆ quality check passed
โœ” done โ€” backed by real evidence

Why Superloopy

"Done" should mean more than a confident sentence.

Superloopy is for Codex work where the final gate has to be real. Every pass leaves proof behind.

๐Ÿงพ

Evidence-first

Every pass points at a real artifact under .superloopy/evidence/. No proof, no "done."

๐Ÿชถ

Lightweight by default

One small CLI, repo-local state, zero runtime dependencies. Just Node โ‰ฅ 20.

๐Ÿค

Agent-friendly

Skills, hooks, and optional crew lanes guide Codex โ€” without ever hiding the final gate.

Skills

A small command layer. Specialist workflows on top.

Skills carry the workflow: when to use it, what to inspect, and what proof to leave behind.

๐Ÿ”

loop

loopy <task> runs a full evidence loop โ€” plan, guided actions, command-backed proof, a quality gate, and a final report.

๐Ÿ”ฌ

research

loopy research fans out search axes, keeps a claim ledger, verifies, and synthesizes a cited artifact.

๐Ÿงฌ

clone

loopy clone rebuilds an authorized site pixel-close โ€” captures, tokens, assets, build, and visual QA.

The crew

Summon the crew for bigger work.

Six optional subagents, each owns one lane. loopy team <task> fans the work out in parallel โ€” and still proves every piece before it calls it done.

franky
frankybuilds it
zoro
zororeviews it
usopp
usopptests it
jinbe
jinbegates it
robin
robinaudits it
nami
namifinds it

Install

Two commands. Then just type loopy.

Needs Node.js โ‰ฅ 20 and Codex CLI โ‰ฅ 0.131.0.

codex CLI
$ codex plugin marketplace add https://github.com/beefiker/superloopy
$ codex plugin add superloopy@beefiker

Restart Codex after installing. A one-time SessionStart bootstrap installs the superloopy command and the crew. Verify with superloopy doctor.