Skip to content

compozy session reparent

Nest a top-level session under another session, or make it top-level again

For people running agent work72 pages in this section

compozy session reparent

Nest a top-level session under another session, or make it top-level again

Synopsis

Adopt a session that has no parent as a child of another user session in the same workspace and profile, or make a previously adopted child top-level again. Subagents, spawned workers, and continued or forked sessions keep their lineage.

compozy session reparent <id> [flags]

Examples

  # Nest a top-level session under another session
  compozy session reparent sess_child --parent sess_parent

  # Make an adopted child top-level again
  compozy session reparent sess_child --top-level

Options

  -h, --help            help for reparent
      --parent string   Parent session ID to nest the session under
      --top-level       Make an adopted child session top-level again

Options inherited from parent commands

      --json             Emit JSON output
  -o, --output string    Output format: human, json, jsonl, or toon (default "human")
      --profile string   Act as a profile for this command

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 reparent <id> -o json

On this page