compozy session subagents delete
Delete a delegated subagent and its child session
579 pages in CLI Reference
On this page5
Usage
compozy session subagents delete <subagent-id> [flags]Options1
- --help-h
- help for delete
Inherited options4
- --json
- Emit JSON output
- --output-ostring
- Output format: human, json, jsonl, or toon (default "human")
- --profilestring
- Act as a profile for this command
- --workspacestring
- Override workspace (ID, name, or path); fast path for show/cancel/delete that avoids searching across workspaces
Synopsis
Delete a delegated subagent permanently, together with its child session's transcript and history. Provider-native subagents follow the parent turn and are refused.
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 subagents delete <subagent-id> -o json