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. Read the first three pages in order; after that, look things up as you need them.
Start here
- Install Homebrew, cargo, or a prebuilt binary. About two minutes from start to a working CLI.
- Quickstart Five minutes in an existing Git repo: start a task, capture work, read the thread, land it back to Git.
- Task threads The concept to read first: why the unit of work in Heddle is the task, not the commit.
Go deeper
- CLI reference Every command and flag, with exit codes and examples.
- Guides Adopting a repo, reviewing a task, recovering work, signing.
- Concepts Captures, forks, annotations, signing, the oplog.
- Compare How Heddle compares with git worktree, jj, GitButler, Entire and Oak.
- Architecture How Heddle is built: the crates and the rules they follow.
- Sley ⇄ Git parity How closely Sley, the Git engine under Heddle, matches Git.
- Troubleshooting What an error means and how to fix it.
- Changelog What changed in each release.