Skip to content

compozy session pin

Pin a session above the session list

584 pages in CLI Reference

On this page6

Usage

compozy session pin <id> [flags]

Examples2

  1. Keep a session at the top of the list

    compozy session pin sess-123
  2. List 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.

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

Example:

compozy session pin <id> -o json