Sessions

Resume, fork, branch, compact, and export transcripts.

Docs on GitHub

Every turn is appended to a JSONL transcript under $ZOT_HOME. Resume the last session with -c, pick one with -r, or browse them all from /sessions. Jump between past turns with /jump without editing history.

Free up context without losing the thread with /compact, which summarizes the transcript into a single message and keeps the last few exchanges verbatim. zot auto-compacts when you cross 85% of the model's context window.

Heavier operations

  • /session export writes the transcript to a portable .zotsession file.
  • /session import pulls one back in as a first-class resumable session.
  • /session fork branches from any past user message into a new session.
  • /session tree shows every branch in this directory and lets you switch into any of them.

Export covers only the main chat thread. /swarm subagents are not bundled: their per-agent state lives in a unix-socket inbox and a session file on disk, neither of which round-trips through a JSONL file.