Skip to content

compozy session archive

Archive a stopped session, or stop and archive a live one with --stop

For people running agent work88 pages in this section

compozy session archive

Archive a stopped session, or stop and archive a live one with --stop

compozy session archive <id> [flags]

Options

  -h, --help                  help for archive
      --keep-processes        Keep session-owned processes running (default)
      --stop                  Stop a live session through the normal stop path (canceling any active turn) before archiving it
      --terminate-processes   Terminate session-owned background processes and terminals
      --with-children         Also archive the session's child sessions, recursively; with --stop a failed stop archives nothing

Options inherited from parent commands

      --json             Emit JSON output
  -o, --output string    Output format: human, json, jsonl, or toon (default "human")
      --profile string   Act as a profile for this command

Output Formats

The root -o, --output flag accepts these values. A renderer is supported only when this command writes that result; jsonl is for commands that emit one JSON record per line.

FormatCommand result
humanInteractive terminal rendering
jsonMachine-readable JSON rendering
jsonlOne JSON record per line when supported
toonCompact agent-readable rendering

Example:

compozy session archive <id> -o json

On this page