compozy session pin
Pin a session above the session list
584 pages in CLI Reference
Usage
compozy session pin <id> [flags]Examples2
Keep a session at the top of the list
compozy session pin sess-123List what is pinned, in pin order
compozy session list --pinned only --sort pinned
Options1
- --help-h
- help for pin
Inherited options3
- --json
- Emit JSON output
- --output-ostring
- Output format: human, json, jsonl, or toon (default "human")
- --profilestring
- Act as a profile for this command
Synopsis
Pin a session above the session list. It moves on its own to the Pinned section at the top, above every project group and folder; its folder, manual position and activity order are kept. Pinning a pinned session changes nothing. Subagent sessions and always-on agents' main sessions cannot be pinned.
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.
| Format | Command result |
|---|---|
human | Interactive terminal rendering |
json | Machine-readable JSON rendering |
jsonl | One JSON record per line when supported |
toon | Compact agent-readable rendering |
Example:
compozy session pin <id> -o json