Getting started

repo-harness turns a Claude or Codex coding session into a repeatable, repo-local workflow. You hand an agent an approved plan, it works in an isolated branch, and you review the result from files — not from chat memory.

Quickstart

# install the runtime (pulls in Bun if missing)
curl -fsSL https://raw.githubusercontent.com/Ancienttwo/repo-harness/main/install.sh | sh
repo-harness init

# from your repo root — preview, then apply
repo-harness adopt --dry-run
repo-harness adopt

That’s the whole path. For prerequisites, per-agent wiring (Claude Code / Codex), the file tree adopt creates, and how to verify the guards are live, follow the Setup guide.

The review loop

After adoption your loop is just review and next:

• the agent works against an approved plan in plans/;
• progress is filed under tasks/ — contracts, reviews, notes;
• each task ends with one Human Review Card: verdict, intended vs actual files, the commands that passed, residual risk, and a one-line rollback.

Next up: the workflow.