Session

CompozyOS RuntimeSession

compozy session history

Show session history grouped by turn

Audience: Operators running durable agent work
Focus: Session guidance shaped for scanability, day-two clarity, and operator context.

compozy session history

Show session history grouped by turn

compozy session history <id> [flags]

Examples

  # Show replayable turn history for one session
  compozy session history sess_1234

  # Show turns after a known event sequence
  compozy session history sess_1234 --after 120 --last 10

Options

      --after int   Show turns after the supplied event sequence
  -h, --help        help for history
      --last int    Show only the most recent N turns

Options inherited from parent commands

      --json            Emit JSON output
  -o, --output string   Output format: human, json, jsonl, or toon (default "human")

Output Formats

Every Compozy command supports -o, --output:

human for interactive terminal use
json for scripts and other machine-readable consumers
jsonl for wait or streaming commands that emit one JSON record per line
toon for compact agent-readable summaries

Example:

compozy session history <id> -o json

compozy session health

Read session health and wake eligibility

compozy session inspect

Inspect session health, wake audit, and policy correlation

On this page

compozy session history Examples Options Options inherited from parent commands Output Formats