git404hub

what is superloopy fr?

beefiker/superloopy — explained in plain English

Analysis updated 2026-05-18

101JavaScriptAudience · developerComplexity · 2/5Setup · easy

tl;dr

A CLI loop harness for Codex and Claude Code that requires each step of a task to be proven with real command output or evidence files before it counts as done.

vibe map

mindmap
  root((Superloopy))
    What it does
      Evidence based loop
      Rerun to verify
      Blocks fake done claims
    Optional skills
      Research
      Site clone
      Frontend build
      Slides
    Tech stack
      Node.js
      CLI
    Hosts
      Codex
      Claude Code

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Have an AI coding agent prove each step of a task with real evidence before calling it done.

VIBE 2

Run a structured research task that produces a cited writeup instead of an unverified summary.

VIBE 3

Clone an existing website with visual proof the result matches the original.

VIBE 4

Convert a presentation into a single-file web deck.

what's the stack?

JavaScriptNode.jsCodexClaude Code

how it stacks up fr

beefiker/superloopyskevy/babel-preset-react-native-stage-0techjarves/local-ai-image-generator
Stars101101101
LanguageJavaScriptJavaScriptJavaScript
Last pushed2017-11-28
MaintenanceDormant
Setup difficultyeasyeasyeasy
Complexity2/52/52/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 30min

Zero runtime dependencies, installs as a CLI plus optional skills and subagents.

in plain english

Superloopy is a command layer for Codex and Claude Code that turns a short instruction, typed as loopy followed by a task, into a guided loop where the AI agent plans the work, proves each step with a real file or command result, and only reports the task done once that evidence exists. The idea is to stop an agent from just claiming success in a confident sentence without anything to back it up. At its center is a distinction between two kinds of proof. Command-backed criteria are checked by literally rerunning the command again at the end and requiring it to still pass, so a stale or made-up result cannot slip through. Manual criteria, ones without a command to rerun, are instead checked by requiring a real evidence file to exist, with the final judgment left to a human or reviewing agent rather than an automatic rerun. Beyond the core loop, the project ships several optional add-on skills. One helps diagnose problems with the installation itself. Another runs a structured research process that produces a list of claims and a cited writeup. Others handle cloning an existing website with visual proof it matches, building frontend UI across web, desktop, and mobile targets, converting a presentation into a single web page, and rewriting Korean text to sound less like AI output. For bigger tasks, it can also hand off pieces of work to six optional named subagents, each responsible for one lane of the job. The tool itself is lightweight: a single small command-line program with no runtime dependencies, and all its state kept inside a project's own .superloopy folder rather than anywhere external. It works with both the Codex and Claude Code coding assistants, and its README is available in English, Korean, Chinese, Japanese, and Spanish.

prompts (copy fr)

prompt 1
loopy add a payments module and prove each step with real evidence.
prompt 2
loopy research the tradeoffs between two caching strategies and cite your sources.
prompt 3
loopy clone this website and show visual QA evidence it matches.

Frequently asked questions

what is superloopy fr?

A CLI loop harness for Codex and Claude Code that requires each step of a task to be proven with real command output or evidence files before it counts as done.

What language is superloopy written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, Codex.

How hard is superloopy to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is superloopy for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.