Local-first multi-agent orchestration for Claude Code and Codex CLI

Loop Engineer is an open-source, local-first multi-agent software-engineering orchestrator for Claude Code, Codex CLI, and isolated Git worktrees. It assigns each AI agent one narrow role, validates every handoff, and keeps generated changes out of your branch until you approve them.

Install View on GitHub

What is Loop Engineer?

Loop Engineer coordinates the official Claude Code and OpenAI Codex CLIs together with local test tooling in one controlled development loop. Instead of a single long agent chat that mixes discovery, implementation, testing, and approval, Loop Engineer splits those responsibilities into roles with narrow contracts: analyst, planner, implementer, tester, reviewer, fixer, and final judge.

Local-first Runs entirely on your machine. No cloud account, no API keys, no telemetry. Provider login stays inside the official CLIs.
Isolated Git worktrees Writing agents edit only a detached worktree. Loop Engineer never commits and never pushes.
Objective quality gates Tests and review findings decide when the loop stops — not the model's self-assessment.
Validated handoffs Roles exchange structured, schema-validated JSON instead of raw chat transcripts.

How does Loop Engineer work?

ANALYZE → PLAN → IMPLEMENT → TEST → REVIEW → DECIDE
                      ↑                    |
                      └──────── FIX ←──────┘

Read-only roles inspect the repository, writing roles edit an isolated worktree, and a local command runner executes only allowlisted test commands. Every run ends with a Markdown report, a JSON report, and a reviewable worktree. Read the full workflow description.

Get started

git clone https://github.com/BotondCsereklye/LoopEngineer.git
cd LoopEngineer
npm ci && npm run build && npm link

loopeng init
loopeng doctor
loopeng gui

See the installation guide for requirements and provider setup, or jump straight to the FAQ.

Loop Engineer is an unofficial open-source project. OpenAI and Anthropic do not sponsor or endorse it. Review generated code and provider output before using either.