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

      --agent string                               Agent definition name (defaults to config default)
      --cwd string                                 Absolute workspace directory to auto-register
  -h, --help                                       help for new
      --name string                                Optional session label
      --network string                             Network participation mode: local or live
      --network-bounds string                      JSON object for live participation bounds (one object, not flag explosion)
      --network-channel string                     Named channel id when strategy is named
      --network-channel-strategy string            Live channel strategy: named
      --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")

compozy session new -o json