Module cli_args 

CLI argument structures.

Structs

AgentApiListArgs

Arguments for agent list.

AgentCaptureArgs

Arguments for agent capture under a current reservation lease.

AgentFanoutPlanArgs

Arguments shared by agent fanout plan and agent fanout start.

AgentFanoutStartArgs

Arguments for agent fanout start.

AgentHeartbeatArgs

Arguments for agent heartbeat.

AgentPresenceCompleteArgs

Arguments for presence complete.

AgentPresenceExplainArgs

Arguments for presence explain.

AgentPresenceListArgs

Arguments for presence list.

AgentPresenceShowArgs

Arguments for presence show.

AgentProvenanceBeginArgs

Arguments for agent provenance begin.

AgentProvenanceEndArgs

Arguments for agent provenance end.

AgentProvenanceListArgs

Arguments for agent provenance list.

AgentProvenanceSegmentArgs

Arguments for agent provenance segment.

AgentProvenanceShowArgs

Arguments for agent provenance show.

AgentReadyArgs

Arguments for agent ready under a writer lease.

AgentReleaseArgs

Arguments for agent release.

AgentReserveArgs

Arguments for agent reserve.

AgentTaskCreateArgs

Arguments for agent task create.

AgentTaskListArgs

Arguments for agent task list.

AgentTaskShowArgs

Arguments for agent task show.

AgentTaskUpdateArgs

Arguments for agent task update.

AuthoredMessageArgs

Inline --body / -m or --file authored text.

BlameArgs

Line-by-line attribution for a tracked file (heddle blame <path>).

Cli

Heddle: An AI-native version control system.

CloneArgs

Arguments for the clone command.

CodeScopeArgs

--path / --symbol / --line code scope.

CollapseArgs

Arguments for the collapse command.

ContextGetArgs

Arguments for heddle context get.

ContextRmArgs

Arguments for heddle context rm.

ContextSetArgs

Arguments for heddle context set.

ContextSupersedeArgs

DiffArgs

Arguments for the diff command.

DiscussArgs

heddle discuss — every action is a subcommand.

DiscussListArgs

DiscussNewArgs

DiscussReopenArgs

DiscussReplyArgs

DiscussResolveArgs

DiscussShowArgs

DiscussWaitArgs

DoctorArgs

Arguments for the doctor command (and its subcommands).

DoctorDocsArgs

Arguments for heddle doctor docs.

DryRunArgs

--dry-run: perform no mutation.

EnvCreateArgs

EnvListArgs

EnvRunArgs

ExpandArgs

Arguments for the expand command.

FsckArgs

FsckRepairGitArgs

HistoricalRevisionArgs

Historical revision selector. Always --state.

HookInstallSource

HostedServerArgs

Hosted server choice shared by grant/promote/import/claim-style commands.

ImportArgs

ImportLocalArgs

Arguments for heddle import local.

InitArgs

Arguments for the init command.

IntegrationInstallArgs

IntegrationRelayArgs

IntegrationStampArgs

IntegrationTargetArgs

LandArgs

Arguments for the land command.

LogArgs

Arguments for the log command.

PullArgs

Arguments for the pull command.

PurgeApplyArgs

PurgeListArgs

PushArgs

Arguments for the push command.

QueryArgs

ReadyArgs

Arguments for the ready command.

RedactApplyArgs

RedactListArgs

RedactShowArgs

RemoteChoiceArgs

--remote flag with no injected default.

ResolveArgs

Arguments for the resolve command.

RevertArgs

Arguments for the revert command.

ReviewApproveArgs

ReviewHealthArgs

ReviewListArgs

ReviewNextArgs

ReviewReadinessArgs

ReviewRevokeArgs

ReviewShowArgs

ReviewSignArgs

SnapshotArgs

Arguments for the capture command.

SyncArgs

Arguments for the sync command.

ThreadAbsorbArgs

Arguments for thread absorb.

ThreadCapturesArgs

Arguments for thread captures.

ThreadCheckoutArgs

Arguments for thread checkout.

ThreadCleanupArgs

Arguments for heddle thread cleanup.

ThreadDropArgs

Arguments for thread drop.

ThreadListArgs

Arguments for heddle thread list.

ThreadMoveArgs

Arguments for thread move.

ThreadNameArgs

Arguments for commands that take a thread identifier. Omitting the positional resolves to the current thread when one can be inferred from the working checkout.

ThreadRenameArgs

Arguments for thread rename.

ThreadResolveArgs

Arguments for thread resolve.

ThreadShowArgs

Arguments for thread show.

ThreadStartArgs

Arguments for the thread start and top-level start commands.

TimelineForkArgs

Arguments for heddle agent timeline fork.

TimelineRecordFinishArgs

Arguments for heddle agent timeline record-finish.

TimelineRecordStartArgs

Arguments for heddle agent timeline record-start.

TimelineRecordToolArgs

Shared scrubbed native tool-call identity for timeline recording commands.

TimelineRecoverArgs

Arguments for heddle agent timeline recover.

TimelineResetArgs

Arguments for heddle agent timeline reset.

TimelineStatusArgs

Arguments for heddle agent timeline status.

TimelineTargetArgs

Shared selector arguments for timeline action commands.

UndoArgs

Arguments for the undo command.

VisibilityListArgs

VisibilityPromoteArgs

VisibilitySetArgs

VisibilityShowArgs

WatchArgs

Arguments for the watch command.

Enums

AgentCommands

AgentFanoutCommands

AgentProvenanceCommands

AgentReleaseStatusArg

AgentTaskCommands

AgentTaskStatusArg

CliOutputMode

CloneSourceArg

Explicit clone protocol. Failures are not retried on the other protocol.

Commands

CompletionSubject

ContextCommands

Context subcommands.

DaemonCommands

Daemon control plane subcommands. See Commands::Daemon.

DiffBaseArg

Named bases shared by diff and review change selection.

DiscussCommands

DoctorCommands

heddle doctor <subcommand> surface.

EnvCommands

FsckCommands

FsckRepairCommands

HookCommands

ImportCommands

IntegrationCommands

MaintenanceCommands

Maintenance subcommands.

NetdCommands

Box-scoped network daemon subcommands. See Commands::Netd.

OplogCommands

OutputMode

PresenceCommands

PurgeCommands

RedactCommands

RemoteCommands

ResolveModeArg

ReviewCommands

ShellCommands

ShellKind

SignKindArg

ThreadCommands

ThreadMarkerCommands

ThreadOwnershipCommands

TimelineCommands

Timeline navigation action commands.

VisibilityCommands

VisibilityTierArg

CLI surface for the tier enum. VisibilityTier carries a label on its team-scoped / restricted / private variants, so it can’t derive ValueEnum directly; this flat enum + --label reconstructs it. Kept in lockstep with VisibilityTier by VisibilityTierArg::into_tier.

WorkspaceModeArg

User-facing --workspace flag values. Vocabulary is the same as repo::ThreadMode (and the on-wire thread.mode JSON field) so a single name carries through the CLI, the daemon, and the thread record on disk. See docs/design/clonefile-threads.md for the rationale.

Constants

IMPORT_VERB

INIT_VERB

Verb key for heddle init.

Traits

CliContext

Small projection of Cli that hosted commands rely on. Defining the surface here lets the hosted-client implementation compile against the parsed CLI state without depending on cli.

Functions

format_unrecognized_suggestion

Clap-shaped usage error that names the near-miss.

safe_clone_destination_basename

Derive a destination directory from a clone source when the user omitted one.

should_output_json

Resolve whether command output should use JSON after applying user, repository, and explicit CLI output settings.

split_path_and_revision

Split --path / --state into a file target, a state target, and a historical revision to read.

suggested_command

Suggested replacement for an unrecognized top-level subcommand.