Session
compozy session
Manage Compozy sessions
- Audience
- Operators running durable agent work
- Focus
- Session guidance shaped for scanability, day-two clarity, and operator context.
compozy session
Manage Compozy sessions
Options
-h, --help help for sessionOptions 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:
humanfor interactive terminal usejsonfor scripts and other machine-readable consumersjsonlfor wait or streaming commands that emit one JSON record per linetoonfor compact agent-readable summaries
Subcommands
| Command | Description |
|---|---|
| compozy session approve | Approve or reject a pending session permission request |
| compozy session clarify | Manage live session questions |
| compozy session events | Read session events |
| compozy session health | Read session health and wake eligibility |
| compozy session history | Show session history grouped by turn |
| compozy session inspect | Inspect session health, wake audit, and policy correlation |
| compozy session list | List sessions |
| compozy session new | Create a new session |
| compozy session prompt | Send a prompt to a session |
| compozy session recap | Show deterministic session recap |
| compozy session remove | Remove a session and its persisted history |
| compozy session repair | Inspect and repair an interrupted session transcript |
| compozy session resume | Attach to a resumable session |
| compozy session soul | Manage session Soul snapshots |
| compozy session status | Show session status |
| compozy session stop | Stop a session |
| compozy session usage | Show aggregated session token usage and cost provenance |
| compozy session wait | Block until a session stops |