Session
compozy session prompt
Send a prompt to a session
- Audience
- Operators running durable agent work
- Focus
- Session guidance shaped for scanability, day-two clarity, and operator context.
compozy session prompt
Send a prompt to a session
compozy session prompt <id> <message> [flags]Examples
# Send a follow-up prompt to an active session
compozy session prompt sess_1234 "Summarize the current changes."
# Queue input while the session is busy
compozy session prompt sess_1234 "Run the next check." --queue
# Steer the current turn after the next tool result
compozy session prompt sess_1234 "Prefer the smaller patch." --steer
# Cancel queued input by entry id
compozy session prompt sess_1234 --cancel queue_entry_1234Options
--cancel string Cancel a queued prompt entry by id
-h, --help help for prompt
--interrupt Interrupt the active turn before sending this prompt
--queue Queue the prompt if the session is busy
--steer Stage steering guidance for the active turnOptions 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
Example:
compozy session prompt <id> <message> -o json