Skip to content

dancingteeth/agent-looper

v0.1.0MIT

Portable Agent Plugins skills for designing and running Agent Looper fix-until-green cycles.

GitHubOpen Website

tags:

  • agentic_ai
  • agents
  • documentation
  • loops

Agent Looper (Cursor companion plugin)

Guidance for designing and wiring Agent Looper — the fix-until-green harness. This plugin does not install the CLI; it teaches the IDE agent how to use it.

What you get

ComponentPurpose
Skill design-loopFreeze measurable GOAL.md + verify.sh
Skill install-agent-loopernpm install, init, scripts
Skill review-gatepostQualityReview / reviewGate without thrash
Rule agent-looperSparse working agreements
Command /loop-scaffoldGuided loop bundle creation

Install locally (before marketplace)

mkdir -p ~/.cursor/plugins/local
ln -sfn /ABS/PATH/TO/agent-looper/plugins/agent-looper ~/.cursor/plugins/local/agent-looper

Reload the Cursor window, then exercise the skills / /loop-scaffold.

Marketplace

Repo uses a multi-plugin layout:

  • .cursor-plugin/marketplace.json — registry entry
  • plugins/agent-looper/.cursor-plugin/plugin.json — Cursor Plugin manifest
  • plugins/agent-looper/plugin.json — portable Agent Plugins manifest (skills-only clients, including Agent Looper itself)

Submit the repository URL at cursor.com/marketplace/publish after local testing.

Harness dogfood

In this repo, loops can attach these skills via:

{
  "plugins": ["plugins/agent-looper"]
}

The worker prompt indexes name + description by default (skillDisclosure: "index").

Runtime install

pnpm add -D @dancingteeth/agent-looper @cursor/sdk
pnpm exec agent-loop-init