Skip to content
Get packs

Loop Engineering

Pattern library and CLI for designing loops that let AI coding agents run repo tasks unattended.

GitHub Download v1.6.0
Stars
11.7k
Forks
1.6k
Licence
MIT
Language
TypeScript
Last update
4 days ago
Type
Learning resource

What it is

Loop Engineering is a collection of patterns, starter files and command-line tools for setting up recurring workflows where AI coding agents (such as Claude Code, Grok, Codex or Opencode) discover work on a codebase, hand it to agents, verify results and save state. The README frames it as designing the system that prompts agents, instead of typing each prompt yourself. Week one is described as report-only, with a staged rollout from report to assisted to unattended.

  • Run a daily triage report on issues, CI and dependencies with the daily-triage pattern
  • Set up a thin loop inside GitHub Actions with minimal files
  • Estimate loop cost with the cost command for a given pattern and level
  • Check a repo's readiness with the doctor and audit commands
  • Draft changelogs or propose issue triage in report-only mode

Great for

  • Developers who already use AI coding agents and want recurring repo chores like issue triage or CI checks
  • Teams wanting a cautious, report-first way to automate dependency or PR follow-up
  • People who want a GitHub Actions loop with few files (the thin loop starter)
  • Readers wanting a structured vocabulary and examples for agent workflows

Not ideal for

  • People new to coding agents, since the README assumes familiarity with tools like Claude Code and STATE.md-style state files
  • Teams that need unattended automation right away, because the README advises running report-only first and warns that token costs can grow quickly
  • Anyone seeking a single packaged application; this is primarily patterns and starters
Step-by-step guide: how to use Loop EngineeringInstall, first run, examples, tips and FAQs

How to get it

  1. 1

    Install with a package manager

    You'll need: Node.js (version not stated in the README) · An AI coding agent tool such as Claude Code, Grok, Codex or Opencode, if you want agent runs

    Initialize a daily triage loop in your repo

    npx @cobusgreyling/loop init . --pattern daily-triage --tool claude

    Check the setup

    npx @cobusgreyling/loop doctor .
  2. 2

    Run it

    • Run the init command with the daily-triage pattern in your repository root
    • Run the doctor command to check the setup
    • Review the generated report during week one, since the default mode is report-only
    • Use the cost command to estimate spend before moving to higher levels
  3. 3

    Get the most out of it

    • Start with the Quickstart and the daily-triage pattern before trying others
    • Use the thin loop starter if you want GitHub Actions with few files
    • Follow the refactor path when you want todos turned into small PRs
    • Read the failure modes and safety docs before enabling unattended levels
    • Use the pattern picker on the showcase site to choose a pattern

Downloads

Source code (.zip)main branch · straight from GitHubRelease v1.6.0Release notes and sourceOfficial website & docscobusgreyling.github.io/loop-engineering/

Strengths

  • Clear staged rollout guidance (report, then assisted, then unattended) with explicit warnings about risk
  • Covers multiple agent tools (Claude Code, Grok, Codex, Opencode, GitHub Actions examples)
  • Includes failure modes, anti-patterns and safety docs, not just success stories

Trade-offs

  • The README is long and points to many linked docs; the scope can feel sprawling for a first visit
  • Several capabilities depend on the agent tools and their accounts, which are outside this repo
  • Terminology such as Loop Ready score and L1/L2/L3 levels needs reading the linked docs to fully understand

How it compares

ProjectStarsTypeLevelUpdatedBest for
loop-engineering (this)11.7kLearning resourceintermediate4 days agoDevelopers who already use AI coding agents and want recurring repo chores like issue triage or CI checks
paperclip110kAppadvanced4 days agoDevelopers already running several AI coding agents who want one place to track them
agents42.1kDev toolbeginner5 days agoDevelopers who already use one of the listed AI coding tools and want ready-made specialist agents
happy24.4kAppintermediate4 days agoDevelopers who already pay for Claude, Codex or Grok subscriptions and want one interface for them
ECC295kDev toolintermediate4 days agoDevelopers who already use Claude Code and want a shared workflow for planning, testing and review
hermes-agent260kAI model / agentintermediate4 days agoDevelopers who want a personal agent they can host on their own server or machine

Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.