loop-engineer

What it does

You describe a goal in one or two sentences — any goal. The skill researches the problem space, discovers every available resource (MCPs, skills, APIs, datasets, local tools), plans atomic tasks, assembles a team of specialists tailored to the domain, then executes fully autonomously until every task passes verification or the budget runs out. No further user input needed after the two setup questions.

Works for any objective: software development, research papers, data analysis, content creation, automation pipelines, system configuration, or anything else.

What makes it different from a single-agent prompt:

• Domain-agnostic by design — no hardcoded task types or procedures. Agents derive their behavior from the goal. The same framework that builds a web service can write a research report or configure a data pipeline.
• Self-assembling agent team — after planning, an agent-factory creates 1–3 specialized agents tuned to the specific goal domain and writes an AGENTS.md manifest. Executors check this and use specialists when available. If generic agents are sufficient, factory creates nothing.
• Resource scout runs before everything — discovers MCPs, skills, local tools, APIs, and datasets relevant to the goal. Writes a usage guide with exact callable names and invocation syntax so executors never have to guess.
• Researcher runs before every executor pass — the executor never acts blind. The researcher consults a 33-category knowledge-sources directory to find the right research channels for the goal domain, then prioritizes finding existing tools, MCPs, libraries, and APIs before planning how to build. Writes structured findings for two audiences: executor (how to do it) and verifier/auditor (verification criteria and quality standards).
• Memory accumulates across tasks and loops — each completed task distills learnings into MEMORY.md. The .global/MEMORY.md persists across all loops in the project so the agent gets smarter over time.
• Fully autonomous failure handling — 3 verifier failures → auto-skip; auditor BLOCK → auto-fix once then skip. Never pauses for user input.

Supported platforms

All entries below confirmed against each vendor's own current documentation (fetched directly, not secondhand).

Install

Plugin system — Claude Code (recommended, auto-updates)

claude plugin add https://github.com/vibhasdutta/loop-engineer

One-liner — macOS / Linux (Claude Code)

curl -s https://raw.githubusercontent.com/vibhasdutta/loop-engineer/main/install.sh | bash

Manual — macOS / Linux

git clone https://github.com/vibhasdutta/loop-engineer.git
cd loop-engineer
bash install.sh              # Claude Code (default)
bash install.sh --cursor     # Cursor
bash install.sh --gemini     # Gemini CLI
bash install.sh --antigravity # Antigravity (CLI + IDE + 2.0)
bash install.sh --opencode   # OpenCode
bash install.sh --hermes     # Hermes Agent
bash install.sh --codex      # OpenAI Codex CLI
bash install.sh --copilot    # VS Code GitHub Copilot
bash install.sh --all        # all platforms

Manual — Windows (PowerShell)

git clone https://github.com/vibhasdutta/loop-engineer.git
cd loop-engineer
.\install.ps1              # Claude Code (default)
.\install.ps1 -Cursor      # Cursor
.\install.ps1 -Gemini      # Gemini CLI
.\install.ps1 -Antigravity # Antigravity (CLI + IDE + 2.0)
.\install.ps1 -OpenCode    # OpenCode
.\install.ps1 -Hermes      # Hermes Agent
.\install.ps1 -Codex       # OpenAI Codex CLI
.\install.ps1 -Copilot     # VS Code GitHub Copilot
.\install.ps1 -All         # all platforms

→ Full installation guide with per-platform verify steps

Quick start

Claude Code / Cursor — open any project and type:

/loop-engineer

Gemini CLI — describe a multi-step goal (auto-activates) or use the shortcut:

/loop-engineer

Antigravity — in agy, IDE, or 2.0, describe a goal or type:

/loop-engineer

OpenCode — open any project and type:

/loop-engineer

Hermes Agent — type the slash command or describe a multi-step goal:

/loop-engineer

Codex CLI — open Codex and type:

/loop-engineer

This scaffolds the state files and prints a /goal command to paste for the actual loop run.

VS Code GitHub Copilot — after installing:

1. From your project root, run the init command printed by install (or run init-loop.sh --platform copilot directly).
2. Open Copilot Chat, switch to Agent mode.
3. Attach .github/prompts/loop-engineer.prompt.md via #loop-engineer.prompt and describe your goal.

The wizard asks 3 questions only (mode is skipped if passed as an argument, e.g. /loop-engineer patch):

Q1. Mode? build / research / patch / audit
Q2. What do you want the loop to accomplish? (1–2 sentences)
Q3. Auto-commit after each verified task? (yes / no)

Everything else is automatic — LOOP_ID, stop condition, budget, context gathering, task decomposition, resource discovery, agent assembly, and the full execution loop.

Modes:

How it works