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|opencode] [--prefix C-t] [--with-tools] [--no-bar]
constant carry --to codex|claude|opencode [--from RT | --session <path-or-id>] [--json] [--dry-run] [--debug] [--new] [--with-tools]
constant resume [QUERY] [--in codex|claude] [--list] [--all] [--prefix C-t] [--with-tools] [--no-bar]
constant sessions [--from RT] [--all] [--titles] [--json]
constant snapshots [--all]
constant restore SNAPSHOT [--to codex|claude] [--json]
constant rename [--of HANDLE] NEW NAME...
constant pack HANDLE [--out FILE]
constant unpack FILE
constant ps [--json]
constant export (--from RT | --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| Command | What it does |
|---|---|
host | Run an agent CLI in a Constant PTY and switch the live runtime with a prefix key. |
carry | Carry a thread into the target's native session; print a receipt and the resume command. |
resume | Re-host a conversation from the trail; reprints from the record if projections are gone. |
sessions | List carryable sessions. |
snapshots | List the record volumes — per-hop IR snapshots written at every carry. |
restore | Reprint a fresh native session from any record volume. Never overwrites. |
rename | Name a conversation (locks the title; native pickers re-stamped). |
pack | Bundle a conversation's ledger and record volumes into one portable file. |
unpack | Import a packed conversation on another machine. |
ps | Census of every live agent CLI process (alias: live). Read-only. |
export | Export the distilled, redacted neutral IR of a thread. |
doctor | Preflight: runtime CLI versions, session-store presence, codec versions. |
status | Quick orientation: runtime readiness, latest sessions, trail state. |
trail | Show the conversation's chapters and projections for this directory. |
route | Debug view of the fork graph with readable aliases. |
Runtimes (RT): codex, claude, opencode, and gemini as a carry source.
Debug commands
constant distill --from codex --to claude
constant keysdistill 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.