Skip to content

compozy task profile set-worktree

Set a task worktree policy

566 pages in CLI Reference

OpenAI Open in ChatGPTClaude Open in ClaudeGitHub Invertocat
On this page5
  1. Usage
  2. Examples
  3. Options
  4. Inherited options
  5. Output Formats

Usage

compozy task profile set-worktree <id> [flags]

Examples3

  1. Create a fresh worktree for every future run

    compozy task profile set-worktree task_123 --mode per_run

  2. Bind future runs to an existing ready worktree

    compozy task profile set-worktree task_123 --mode ref --ref feature-docs

  3. Output example

    compozy task profile set-worktree task_123 --mode per_run

Options3

--help-h
help for set-worktree
--modestring
Worktree mode: inherit, none, ref, or per_run
--refstring
Attached worktree reference for ref mode

Inherited options3

--json
Emit JSON output
--output-ostring
Output format: human, json, jsonl, or toon (default "human")
--profilestring
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 task profile set-worktree task_123 --mode per_run -o json