CLI reference

heddle agent

Shipped

heddle agent [OPTIONS] <COMMAND>

Agent reservation and one-shot orchestration API

Output text (default)

Subcommands

agent reserve Atomically reserve a thread for one writer
agent heartbeat Update reservation heartbeat
agent capture Capture under a token-authenticated writer lease
agent ready Mark a reservation's thread ready for integration
agent release Release a reservation (status: complete | abandoned)
agent list List agent reservations (optionally filtered to alive ones)
agent task Manage local agent task assignments
agent task create Create a local agent task assignment
agent task list List local agent task assignments
agent task show Show one local agent task assignment
agent task update Update one local agent task assignment
agent fanout Plan and start native fan-out lanes
agent fanout plan Preview fan-out lane setup and return commands without writing
agent fanout start Create task assignments and materialized child lanes
agent provenance Record provider, model, and policy provenance across an agent run
agent provenance begin Begin a provider/model provenance session
agent provenance segment Record a provider, model, or policy change within the current session
agent provenance end End the current or selected provenance session
agent provenance show Show the current or selected provenance session
agent provenance list List provenance sessions
agent presence Inspect attribution and work context for local agents
agent presence list List agent presence records known to this repository
agent presence show Show the current or selected agent presence record
agent presence explain Explain why Heddle attached the current or selected presence record
agent presence complete Mark the current or selected presence record complete
agent timeline Navigate, fork, reset, and recover agent tool-call timelines
agent timeline status Show the current timeline cursor, counts, and recovery status
agent timeline record-start Record the start of a native tool timeline step
agent timeline record-finish Record the finish of a native tool timeline step
agent timeline fork Fork a timeline branch from a step or native harness tool call
agent timeline reset Reset the logical timeline cursor, optionally materializing checkout files
agent timeline recover Recover a pending timeline materialization after an interrupted reset/seek