heddle thread

A thread is the smallest unit of agent work that makes sense to review. It carries a name (e.g. task/biscuit-authz), an assigned agent, a delegator, an ordered list of captures, and — at the end — a merge.

Threads can fork at any capture. Both paths persist; the abandoned one stays attributed and browseable. This is the primitive nothing else has — see the **Fork from capture** concept page.

See also

• heddle init
• heddle capture
• heddle review
• heddle bridge git

Subcommands

The thread family covers everything from starting a thread to cleaning one up. Each subcommand has its own page in v2; for now they're listed here with their one-line summaries.

• thread create Start a new task thread
• thread switch Switch the current checkout to an existing thread ref
• thread list List threads in the repository
• thread show Display one thread with actor and workflow context
• thread captures Show granular captures on a thread
• thread rename Rename a thread ref
• thread refresh Rebase the thread onto its target thread
• thread move Move selected captured paths between threads
• thread absorb Absorb a child thread into its parent or another thread
• thread resolve Guide a blocked or stale thread toward its next clean state
• thread promote Promote a thread to a heavy checkout at a chosen path
• thread drop Drop a thread and mark it abandoned
• thread approve Record a merge approval for source → target (feature-gated: hosted-client)
• thread approvals List approvals recorded for source → target (feature-gated: hosted-client)
• thread revoke-approval Revoke a previously recorded approval by id (feature-gated: hosted-client)
• thread check-merge Check whether source → target would merge under branch-protection policies (read-only, feature-gated)
• thread cleanup Sweep threads that have outlived their usefulness — drop checkouts and registry entries