loop-engineering

(★ 10,527)

Practical patterns, starters & CLI tools for loop engineering with AI coding agents. Design systems that prompt and orchestrate agents (inspired by Addy Osmani and Boris Cherny). Includes loop-audit, loop-init, loop-cost.

Reference Links

🌐 Official Homepage Interactive picker Loop Engineering essay Addy Osmani – Loop Engineering

Owner Repos

llm-wiki ★ 41

A compounding knowledge base maintained by LLM agents — inspired by Karpathy's LLM Wiki pattern

Python
goal-engineering ★ 39

The canonical reference for Grok Build CLI /goal — run-until-done objectives, patterns, verifier skills, and goal-audit CLI.

JavaScript
fleet-engineering ★ 33

Practical reference for fleet engineering, governing populations of AI agents with accountability

JavaScript
NVIDIA-Nemotron-3-Super ★ 29

Controllable reasoning demos for NVIDIA Nemotron 3 Super (120B/12B MoE) — chat UI, CLI, API server, tool calling, budget sweep, and adaptive routing

Python
claude-agent-teams ★ 13

Claude Code Agent Teams — Multi-agent orchestration from your terminal (Opus 4.6)

Shell
harness-foundry ★ 12

Composable harness runtime for production agents — primitives, traces, evolution, outerloop governance.

TypeScript

File Explorer

ZIP Download
  • .gitignore
  • _config.yml
  • AGENTS.md
  • changelog-drafter-state.md
  • CODE_OF_CONDUCT.md
  • CODEOWNERS
  • CONTRIBUTING.md
  • CONTRIBUTORS.md
  • gate.yaml
  • LICENSE
  • loop-budget.md
  • loop-constraints.md
  • loop-run-log.md
  • LOOP.md
  • package-lock.json
  • package.json
  • README.md
  • RELEASE_NOTES_DRAFT.md
  • RELEASE_NOTES_v1.5.0.md
  • SECURITY.md
  • STATE.md

# Installation Guide

node
Prerequisites

Setup Steps

npm install

Install root dependencies.

npm test

Run validation tests for registry and scripts.

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

Initialize a loop engineering template with a chosen pattern and tool.

npx @cobusgreyling/loop doctor .

Diagnose the loop setup readiness and view recommended actions.

Key Commands

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

Scaffolds skills, state, and budget files, then prints the Loop Ready score.

npx @cobusgreyling/loop doctor .

Turns audit and sync into top next action recommendations.

npx @cobusgreyling/loop audit . --suggest

Audits project loop readiness score and provides suggestions.

npx @cobusgreyling/loop cost

Estimates token spend and costs for agent loops.

CLI tools can be executed directly using npx or built individually inside the tools/* subdirectories.

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Link
Example

Release Timeline

Actively Maintained

Command Glossary

Commands referenced in this DOCs, explained below.

🔍

claude

View Details ▼

An agent-based coding tool that understands your code base and helps you code faster through natural language commands.

claude prompt

Execute with prompt:

claude update

Update `claude`:

claude mcp list

Get the list of specified MCP servers:

🔍

codex

View Details ▼

Natural language code assistant for the terminal, powered by OpenAI.
Reads and edits files in your current directory to fulfill requests.

codex

Start an interactive Codex session in the current directory:

codex "{{prompt}}"

Run a single Codex command using a prompt:

codex --sandbox workspace-write "{{prompt}}"

Run a prompt allowing Codex to edit files in the workspace:

🔍

node

View Details ▼

Server-side JavaScript platform (Node.js).

node {{path/to/file}}

Run a JavaScript file:

node

Start a REPL (interactive shell):

node --watch {{path/to/file}}

Execute the specified file restarting the process when an imported file is changed (requires Node.js version 18.11+):

🔍

npx

View Details ▼

This command is an alias of `npm exec`.

tldr npm exec

View documentation for the original command:

🔍

opencode

View Details ▼

An AI coding agent.
Some subcommands such as `auth`, `models`, `web`, etc. have their own usage documentation.

opencode

Start the interactive TUI:

opencode {{[-c|--continue]}}

Continue the most recent session:

opencode run "{{message}}"

Run opencode in non-interactive mode by passing a prompt directly:

// repository documentation