Superloopy is a loop-engineering tool for Codex and Claude Code that verifies each step of a task with evidence before marking it complete.

Stars

102

7-day growth

No data

Forks

13

Open issues

0

License

MIT

Last updated

2026-07-25

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It enforces an evidence-first approach where every task claim is backed by a real artifact, preventing false 'done' statuses, and it integrates seamlessly with Superpowers for end-to-end workflow coordination.

Who it is for

  • Codex and Claude Code power users
  • Developers building complex multi-step workflows
  • Teams that require verifiable task completion
  • Plugin authors and CLI tool integrators

Use cases

  • Automating software development with proof-of-completion for each sub-task
  • Orchestrating parallel subagent crews for large projects
  • Cloning websites with a full evidence trail of page topology and assets
  • Generating zero-dependency slide decks with visual QA evidence

Strengths

  • Command-backed criteria that re-run at the end to guarantee reproducibility
  • Lightweight, zero runtime dependencies, and repo-local state
  • Optional crew subagents that work in parallel and report independently
  • Interoperability with Superpowers without overlapping responsibilities

Considerations

  • Requires specific CLI versions (Codex ≥0.131.0) and Node.js ≥20
  • Manual criteria (without commands) rely on human review for correctness
  • Plugin installation and model resolution can be complex for some users

README quick start

🌀 Superloopy

Loop engineering for Codex and Claude Code. Type loopy — an agent does the work, proves each piece with real evidence, and only then says it's done.

English · 한국어 · 中文(简体) · 日本語 · Español

     

the crew — optional subagents, one job each

Use it

After installing, type your task in Codex or Claude Code with a leading loopy:

loopy add the payments module

The agent plans it, proves each piece with a real file, and reports back — you don't run any commands yourself. The packaged Stop hook stays quiet unless SUPERLOOPY_STOP_HOOK=on.

Why Superloopy?

Superloopy is for Codex and Claude Code work where "done" needs to mean more than a confident status sentence.

  • Evidence-first: every pass points at a real artifact under .superloopy/evidence/.
  • Lightweight by default: one small CLI, repo-local state, zero runtime dependencies.
  • Agent-friendly: skills, hooks, and optional crew lanes guide the agent without hiding the final gate.

Guarantee scope. Command-backed criteria are the strong guarantee: at completion Superloopy re-runs each command in-process and requires it to reproduce, so a stale or fabricated pass cannot reach "done". Manual (commandless) criteria are verified as a non-empty evidence artifact plus auditor/human judgment — their correctness rests on review, not the deterministic re-run.

Skills

Superloopy keeps the command layer small. Skills carry the specialist workflow: when to use it, what the agent should inspect, and what proof must be left under .superloopy/evidence/.

SkillUse it whenWhat it produces
superloopy-loopYou type loopy or loopy team for a full loop; use loopywork, lpy, or $lpy for guidance-only context.Full loops produce a lightweight plan, guided next actions, command-backed proof, a quality gate, and a final evidence report. Guidance aliases do not mutate state.
superloopy-doctorYou diagnose install, wrapper, plugin cache, hook/bootstrap, agent, Codex/Claude Code host wiring, or stale-version problems.A read-only health report with wrapper/cache/version evidence, failing checks, and the exact repair command to run only if approved.
superloopy-researchYou explicitly invoke Codex $superloopy:superloopy-research or Claude Code /superloopy:superloopy-research, o

Description

Lightweight Codex loop harness with strict evidence gates.

Related repositories

Similar projects matched by category, topics, and programming language.

react
Featured
react GitHub avatar

react

React is a JavaScript library for building user interfaces with declarative, component-based, and cross-platform design.

Web DevelopmentFrontend Frameworks
246,741
tandpfun
Featured
tandpfun GitHub avatar

wardrobe

A GPT‑image powered app that extracts individual garment cutouts from photos, organizes them into a digital wardrobe, and generates modeled outfit previews.

JavaScript
1,570
mshumer
Featured
mshumer GitHub avatar

Claude-of-Duty

A browser-based first-person shooter built entirely with procedural generation and orchestrated AI agents, featuring 55k lines of Three.js/WebGL2 code and no art assets.

AI & Machine LearningAI Agents
1,234