compozy session continue
Continue a session with another agent, runtime, or declared route
574 pages in CLI Reference
On this page5
Usage
compozy session continue <session-id> [flags]Options14
- --acp-optionstringArray
- ACP config option as id=value (repeatable)
- --agentstring
- Agent that continues the session (required)
- --expected-epochint
- Transcript epoch the source must still have
- --expected-generationint
- Transcript generation the source must still have
- --expected-max-sequenceint
- Maximum event sequence the source must still have
- --help-h
- help for continue
- --idempotency-keystring
- Stable retry key (generated when omitted)
- --messagestring
- First message for the new session
- --modelstring
- Model for the new session's runtime
- --namestring
- Name of the new session (defaults to the source title)
- --providerstring
- Provider for the new session's runtime
- --reasoning-effortstring
- Reasoning effort for the new session
- --routeint
- 1-based declared route of the agent's fallback_chain (excludes every runtime flag)
- --speedstring
- Speed for the new session (normal|fast)
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
Start a new session for another agent with the source conversation carried over as historical context. The source session is never changed. Re-running with the same --idempotency-key and arguments prints the recorded result instead of creating a second session.
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 continue <session-id> -o json