CLI reference
heddle fork
Shippedheddle fork [--from <state>] [--name <thread>] Fork from any state into a new thread (or as a detached fork) so a second agent can try a different approach without losing the working context.
Fork is the primitive nothing else has: parallel exploration without context loss. Today this is git stash + duplicate worktrees + restart-the-agent. Heddle gives you fork — from any state (defaults to HEAD), branch the working state forward; the original keeps running, the fork is fully attributed and addressable.
If --name is passed, the fork is attached to a thread of that name and becomes the visible name in heddle thread list. Without --name, the fork is detached — still addressable by its state ID, still browseable, but not promoted to a named thread.
Flags
--from <state>- State to fork from. Accepts a state ID, a marker, `HEAD`, `@`, or `HEAD~N`. default:
HEAD --name <thread>- Attach the new fork to a named thread. Without this, the fork is detached.
Examples
Fork from the current state into a named thread
bash$ heddle fork --name task/biscuit-authz.shimCreated fork hd-9c41 on thread 'task/biscuit-authz.shim' from hd-d01a8b4eFork from a specific state as a detached fork
bash$ heddle fork --from hd-9a2fCreated fork hd-c812 from hd-9a2f