Sessions & trail

Constant gives you a few read-only commands to see what is carryable and what it has done.

List carryable sessions

constant sessions
constant sessions --from codex --titles
constant sessions --all --json

By default sessions scopes to the current directory. --all scans all known runtime stores. --titles reads transcripts to derive a preview title, so it is slower on large stores. In text output, · marks a session known to be empty when titles were requested.

Trail

constant trail
constant trail --all
constant trail --events

trail shows the current Constant projection per runtime. If the same projection was updated multiple times, it shows as synced Nx instead of repeating as a new conversation. --events shows the raw append-only switch ledger from ~/.constant/trail.jsonl.

Route

constant route
constant route --all

route is the debug view. It reconstructs the fork graph Constant knows about and labels projections with readable aliases like codex[1] and claude[1.1].

Export the neutral IR

constant export --from codex --out thread.constant.json
constant export --session <path-or-session-id>

export writes the distilled, redacted neutral conversation model. Without --out it prints JSON to stdout. It refuses to overwrite the source session.

Next: What carries.