Install Loop Engineer

Loop Engineer runs locally on macOS, Linux, and Windows. It needs Node.js, Git, and at least one supported official provider CLI.

Requirements

• Node.js 20 or newer
• Git with worktree support
• At least one provider CLI: Claude Code or OpenAI Codex CLI

Install from source

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

npm link puts the loopeng command on your PATH. An npm package (npm install -g loop-engineer) is planned; until it ships, installing from source is the supported path.

Set up a project

Run these commands inside a Git repository with at least one commit:

loopeng init      # writes loop-engineer.yml and detects project commands
loopeng doctor    # checks Node.js, Git, providers, and write access
loopeng gui       # opens the local dashboard at http://127.0.0.1:4317

loopeng doctor verifies Node.js, Git, worktree support, repository state, provider installation and authentication, command detection, instruction files, and write access — so problems surface before your first run.

Connect providers

The dashboard can start claude auth login --claudeai or codex login. Each official CLI owns its browser flow, callback, and credential store. Loop Engineer receives only installed-and-authenticated status — it has no password, API-key, OAuth-code, or access-token field anywhere.

Run your first task

loopeng run --dry-run --task "Add input validation to the settings parser"
loopeng run --task "Add input validation to the settings parser"

Start with --dry-run to preview the workflow without calling any provider. Then read how the loop works and the security model.