heddle thread

Subcommands

The thread family covers everything from starting a thread to cleaning one up. Each subcommand is listed here with its one-line summary; for the full reference, run heddle thread <subcommand> --help at the terminal. The CLI emits structured, publication-quality help.

• thread create Create a thread ref at the current state
• thread current Print the name of the current thread (the thread the working checkout is attached to). Read-only — no state change. Useful in shell pipelines: `cd "$(heddle thread cd "$(heddle thread current)")"`
• thread switch Switch the current checkout to an existing thread ref
• thread cd Print the on-disk path for a thread. Read-only — no state change, no auto-capture. Without a shell hook: cd "$(heddle thread cd X)" With `heddle shell init`, `heddle thread cd X` becomes `cd <path>`
• thread list List threads
• thread show Show one thread with actor and workflow context
• thread captures Show granular captures on a thread
• thread rename Rename a thread ref
• thread refresh Refresh a thread onto its target thread
• thread move Move selected captured paths from one thread into another
• 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 ownership Inspect or explicitly transfer a Thread's native ownership
• thread ownership status Show the local owner or the complete signed conflict
• thread ownership claim Explicitly transfer a local-key Thread to the currently authorized account
• thread ownership resolve Original local owner chooses one accepted claim; the current account accepts
• thread checkout Create a working checkout for this thread
• thread drop Drop a thread and mark it abandoned
• thread cleanup Sweep merged, stale auto-created, or abandoned threads
• thread collapse Collapse (squash) multiple states into one
• thread expand Expand a squashed land into the captures it collapsed
• thread marker Manage named state markers under the thread namespace
• thread marker list List markers, optionally filtered by name prefix
• thread marker create Create marker at current state
• thread marker delete Delete marker(s)
• thread marker show Show marker details