harnessie.com  /  docs  /  Ringer

Harnessie and Ringer

If you found Harnessie through Ringer, you are in the right place. The two are built to fit together.

The same conviction

Ringer and Harnessie start from the same belief, reached independently: a frontier model earns its tokens on orchestration and judgment, most execution does not, and the only result worth trusting is one that has been checked by running it, never one an agent claims is done. Ringer says it plainly: the check is the contract, and exit code zero is the only thing it believes. Harnessie holds the identical line at its gate.

When two tools arrive at the same core conviction on their own, it is usually because the conviction is right. So this is not a rivalry. It is two tools on one foundation, leaning in different directions.

Different emphasis

Ringer optimizes the swarm. Parallel execution across a set of engines (Codex CLI, Grok Build, OpenCode, or your own), local by default, a live dashboard, throughput. It is the fastest way to get a lot of mechanical, verifiable work done cheaply and in parallel on your own machine.

Harnessie optimizes governance. An independent verifier agent on top of the deterministic check, decisions that preserve dissent for a human to arbitrate, a containment boundary that lets you reach for a cloud model without letting sensitive data reach it, and a hash-chained audit of every agent and operator action. It is the harness for when the work itself must be governed, not just executed.

Same foundation, opposite leans. Ringer goes wide and fast. Harnessie goes careful and accountable.

How they compose

{
  "key": "governed-step",
  "spec": "...task for the worker engine...",
  "check": "harnessie verify --workspace {taskdir} --criteria acceptance.md --models models.yaml"
}

The worker's own claims stop being the evidence; a model that never saw the worker's reasoning has to reproduce them. Fail-closed: 0 verified, 1 failed, 2 cannot-verify (nothing was observed, so nothing is asserted).

Verifying an agent-produced pull request

The same command reviews PR-shaped work anywhere. The recipe: check out the PR head, stage its diff alongside it (git diff <base>..HEAD > PR.diff, so the verifier can judge change-surface claims without git), distill the PR body's claims into a criteria file, then:

harnessie verify --workspace <checkout> --criteria claims.md \
  --check "python3 -m pytest tests/ -q" --models models.yaml

The report answers claim by claim: reproduced, refuted, or not verifiable in this environment, with the evidence named. The first public run of this recipe refuted a claim in its own author's pull request, which was the point: a verifier that has never failed its own author is a rubber stamp. The decision record behind the feature (four providers' independent positions, preserved dissent, human arbitration) is public: AIDR-0006.

If you came from Ringer

You already have parallel execution and verification-by-check. Harnessie adds four things, for when you need them:

If you never need those, Ringer alone is the lighter tool, and that is the honest recommendation.

See also