Field manual
The Heddle field manual.
Heddle is a Git-overlay CLI that turns every agent task — captures, retries, aborts, conflicts, one merge — into one named, reviewable, recoverable thread. This is the manual: install, quickstart, the concepts that change how you version code, and the full CLI reference.
The shape of the manual mirrors how you'll use it. Read top to bottom on the first day. After that, look up commands and re-read one concept at a time.
01 — Start here
Install
Homebrew, cargo, or a prebuilt binary. About two minutes from
zero to heddle --version.
02 — Start here
Quickstart
Five minutes. heddle init in an existing Git repo,
capture some work, review it, bridge a merge back to Git. End
to end.
03 — Learn
Task threads
The pillar. Why the unit of work in Heddle is the task, not the commit — and what changes about review when it is.
04 — Look up
CLI reference
Every command, every flag, with examples that use the same throughline data as the marketing scenes. Built to scan.
05 — Soon
Guides
How to adopt an existing repo, review a task, recover an abandoned fork, annotate code for the next agent. Landing as each one is written.
06 — Source
GitHub
The Heddle repository. File a bug, read the Rust workspace, preview the changelog. Heddle is open source.