A CLI and pattern toolkit for orchestrating AI coding agents in automated loops. It provides project scaffolding, cost estimation, state management, and drift detection to reduce manual prompting.
Project overview
A CLI and pattern toolkit for orchestrating AI coding agents in automated loops. It provides project scaffolding, cost estimation, state management, and drift detection to reduce manual prompting.
Project type
AI Coding · Workflow
Use cases
Coding & Development · Automation
Deployment
Refer to project documentation
License
MIT
Best for
Developers and AI engineers managing automated coding agent workflows who need structured patterns and cost controls.
Teams looking to add automated orchestration and verification gates to existing AI coding tools like Grok, Claude Code, or Codex.
Key capabilities
Scaffolds skills, state, and budget files, then prints a Loop Ready score and first loop command.
CLI tool that evaluates a project and suggests improvements for automating agent loops.
Estimates token spend for a specified loop pattern and cadence.
Detects drift between STATE.md and LOOP.md.
Stateful memory manager and circuit breaker for long runs.
MCP runtime lookup for patterns, skills, state.
Manages isolated git worktrees per fix attempt.
Mechanical enforcement of the path denylist and auto-merge allowlist.
Limitations and risks
Unattended loops make unattended mistakes, requiring user verification.
Token costs can explode with sub-agents and long-running loops.
Comprehension debt grows faster unless the user reads what the loop ships.
Getting started
Run via npx without cloning the repository. Start by running the init command with a pattern and target tool, estimate costs, and run an audit.
Evidence and sources
GitHub project description: Practical patterns, starters & CLI tools for loop engineering with AI coding agents.
README: Loop engineering replaces you as the person who prompts the agent — you design the system that does it instead.
README: loop-init scaffolds skills, state, and budget files, then prints your Loop Ready score and first loop command.
README: loop-audit npm
README: Seven production loop patterns with cadence and token cost