Docs/Commands

Commands

Constant feels like git, gh, or rsync: a practical local tool with sharp nouns and predictable output. The read-only commands never write your runtime files.

Public commands

constant host [codex|claude] [--prefix C-t]
constant carry --to codex|claude [--from codex|claude | --session <path-or-id>] [--json] [--dry-run] [--debug] [--new]
constant sessions [--from codex|claude] [--all] [--titles] [--json]
constant export (--from codex|claude | --session <path-or-id>) [--out FILE]
constant doctor [--json]
constant status [--all]
constant trail [--all] [--events]
constant route [--all] [--session <path-or-id>]
constant --version
CommandWhat it does
hostRun an agent CLI in a Constant PTY and switch the live runtime with a prefix key.
carryCarry a thread into the target's native session and print the resume command.
sessionsList carryable sessions.
exportExport the distilled, redacted neutral IR of a thread.
doctorPreflight: runtime CLI versions, session-store presence, codec versions.
statusQuick orientation: runtime readiness, latest sessions, trail state.
trailShow the current Constant projection per runtime for this directory.
routeDebug view of the fork graph with readable aliases.

Debug commands

constant distill --from codex --to claude
constant keys

distill is the older name for carry; the internal cartridge still calls this step distillation. constant keys prints raw key bytes for debugging prefix behavior.

See Keybindings for the hosted-session keys.