Skip to content

compozy session worktree bind

Use a ready worktree for the same conversation

For people running agent work3 pages in this section

compozy session worktree bind

Use a ready worktree for the same conversation

compozy session worktree bind <session> <worktree-ref> [flags]

Options

      --expected-worktree string   Expected current worktree id (empty for workspace root)
  -h, --help                       help for bind

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 worktree bind <session> <worktree-ref> -o json

On this page