compozy session new

compozy session new [flags]

  # Start a session in the current workspace using the configured default agent
  compozy session new

  # Start a named session for a specific registered workspace and agent
  compozy session new --workspace checkout-api --agent reviewer --name review-api

  # Auto-register an absolute workspace path before creating the session
  compozy session new --cwd "$PWD" --agent reviewer

  # Start a recovery session for a failed parent session
  compozy session new --agent codex --parent sess_01J9R2K7M4T1 --lineage-kind recovery

      --agent string                               Agent definition name (defaults to config default)
      --cwd string                                 Absolute workspace directory to auto-register
  -h, --help                                       help for new
      --lineage-kind string                        Relation to --parent: provenance (default) or recovery
      --name string                                Optional session label
      --new-worktree string[="__compozy_auto__"]   Create a worktree before starting; optionally provide its name
      --parent string                              Record a same-workspace parent session as creation provenance
      --workspace string                           Override workspace (ID, name, or path)
      --worktree string                            Start in an existing ready worktree

      --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

compozy session new -o json