CLI reference
heddle ready
Shippedheddle ready [OPTIONS] Prepare this thread for review or merge. Captures outstanding work if needed, checks conflicts, blockers, freshness and semantic risk, then marks the thread ready or blocked. It never lands, checkpoints, or pushes.
Output text (default) · json · json-compact
ready is the checkpoint between doing the work and integrating it. It is allowed to capture outstanding work first — pass -m to give that capture an intent — and then evaluates the thread against its integration target, printing the next action either way.
The one thing it will not do is integrate. The binary's own wording: It never lands, checkpoints, or pushes. That makes it safe to run on a loop.
--dry-run previews the readiness decision — integration target, conflicts, verify verdicts, the transition that would happen — without capturing work or moving the thread to Ready or Blocked. No mutation occurs.
Flags
--thread <thread>- Thread to evaluate for integration readiness.
--message <message>, -m <message>- Intent/message to use if ready needs to capture outstanding work first.
--confidence <number>- Honest confidence estimate (0.0-1.0) if ready captures outstanding work.
--dry-run- Preview the readiness decision without capturing work or moving the thread to Ready/Blocked. No mutation occurs.
Examples
Check a thread before landing it
bash$ heddle ready --dry-run --output json$ heddle ready -m 'scope-narrowing pass'