░█▀▄░█▀▀░█░█░█░░░█▀█░█▀█░█▀█
░█░█░█▀▀░▀▄▀░█░░░█░█░█░█░█▀▀
░▀▀░░▀▀▀░░▀░░▀▀▀░▀▀▀░▀▀▀░▀░░
  

Spec in. Reviewed code out.

devloop runs a local agent loop: Codex implements, Claude Code reviews, and Codex retries until the work is accepted, stalled, unclear, or out of passes.

Install

curl -fsSL https://devloop.sh/install | bash

Or from source:

git clone https://github.com/satyaborg/devloop.git
cd devloop
./scripts/install.sh

Requires Bash, git, codex, claude, gum, and fzf. Run devloop doctor to check.

Uninstall with ./scripts/uninstall.sh (--dry-run to preview).

Usage

Command	Description
devloop	Interactive menu: create, run, or continue a spec
devloop spec "..."	Have an agent interview you and write a spec
devloop <spec.md>	Run a spec
devloop --create-pr <spec.md>	Run a spec and maintain a draft PR (requires gh)
devloop continue	Resume a tracked run
devloop status	Show run status
devloop clean	Remove run artifacts

Each run writes an HTML report, spec, and reviews under .devloop/.

Specs

A good spec is short, concrete, and verifiable. Start from skills/devloop-spec/references/spec-template.md.

Strict mode is on by default: specs need ## Acceptance criteria, and reviews must pass both the spec gate and engineering quality gate.

Skills

Devloop ships two agent skills, installed into ~/.claude/skills and ~/.agents/skills:

• devloop-spec — turns a rough idea, notes, a URL, or an interview into one concrete, devloop-ready spec.
• devloop-review — judges each pass against the spec and engineering quality gates, returning ACCEPT, REJECT, or UNCLEAR with fix instructions.

Runtime

• Uses an isolated sibling git worktree by default; pass --in-place to stay in the current worktree.
• Runs up to 5 passes, commits eligible coder changes, and executes .devloop/verify after each coder pass when present. Keep .devloop/verify local and auditable.
• Writes tracks, reviews, reports, logs, session ids, and spec snapshots under .devloop/; generated worktrees and branches remain for inspection.

Contributing

git clone https://github.com/satyaborg/devloop.git
cd devloop
bash scripts/devloop_test.sh

See CONTRIBUTING.md for setup, full gates, and release notes.

Privacy

devloop adds no telemetry. It runs local agent CLIs against your checkout, so network behavior depends on the agents and commands you configure.

License

MIT