Install

Hadúr is a Python toolkit: a pure engine, a typer CLI, and a Claude Code plugin around the Contract-First Multi-Plan Review methodology. The source repository opens with the public launch; the commands below track the packaged release.

Requirements

• Python 3.11 or newer
• A git repository — Hadúr anchors review evidence to your VCS tree and refuses to count rounds without it (§7.3.4)

Install

pip install hadur
hadur --help

Initialize a repo

From the root of the project you want reviewed:

hadur init

This creates .hadur/ — the record directory: config, round findings, wave history, reviewer briefs. It is bookkeeping, deliberately excluded from the code identity that review rounds are anchored to, and nothing in your project should ever import from it.

Your first verdict

hadur convergence

On a fresh repo this exits non-zero with not met — which is correct: you have not reviewed anything yet. Hadúr never reports confidence it does not have; convergence is something you earn round by round (§7.3), not a default state.

The CLI reference lists every verb and exit code — rendered from the binary itself, so it cannot drift. When you are ready to run a real loop, start with Your first Round–Wave loop.

What Hadúr will never tell you

The tooling verifies artifacts, not attention (§7.3.5). It can prove a brief exists, is pinned, and is anchored to the code on disk; it cannot prove a reviewer read anything. Every met verdict prints that floor. The last line of defence is an honest reviewer — Hadúr exists to make sure that is the only thing you are trusting on faith.