Enum Commands 

pub enum Commands {
    New {
        name: String,
        path: Option<String>,
        base: Option<String>,
        no_term: bool,
        term: Option<String>,
        prompt: Option<String>,
        prompt_file: Option<PathBuf>,
        prompt_stdin: bool,
    },
    Resume {
        branch: Option<String>,
        term: Option<String>,
    },
    Spawn {
        target: Option<String>,
        term: Option<String>,
        prompt: Option<String>,
        prompt_file: Option<PathBuf>,
        prompt_stdin: bool,
    },
    Rm {
        targets: Vec<String>,
        interactive: bool,
        dry_run: bool,
        keep_branch: bool,
        delete_remote: bool,
        force: bool,
        no_force: bool,
    },
    List,
    Ls,
    Doctor {
        session_start: bool,
        quiet: bool,
    },
    Upgrade {
        yes: bool,
    },
    SetupClaude,
    ShellSetup,
    Exec {
        target: String,
        cmd: Vec<String>,
    },
    Run {
        only: Option<String>,
        no_main: bool,
        jobs: usize,
        continue_on_error: bool,
        cmd: Vec<String>,
    },
    Guard {
        tool_input: String,
    },
    Path {
        branch: Option<String>,
        list_branches: bool,
        interactive: bool,
    },
    ShellFunction {
        shell: String,
    },
    UpdateCache,
    CompleteTargets,
    SpawnAi {
        spec: Option<PathBuf>,
    },
}

Variants

New

Create new worktree for feature branch

Fields

name: String

Branch name for the new worktree

path: Option<String>

Custom worktree path (default: ../-)

base: Option<String>

Base branch to create from (default: from config)

no_term: bool

Skip AI tool launch

term: Option<String>

Terminal launch method for THIS invocation. Overrides config and CW_LAUNCH_METHOD. Accepts canonical names (e.g., wezterm-tab) or aliases (e.g., w-t, w-t-b). Supports method:session-name for tmux/zellij. Mutually exclusive with --no-term.

prompt: Option<String>

Initial prompt to pass to the AI tool (starts interactive session with task)

prompt_file: Option<PathBuf>

Read the initial prompt from a file (recommended for multi-line prompts)

prompt_stdin: bool

Read the initial prompt from standard input

Resume

Resume AI work in a worktree

Fields

branch: Option<String>

Branch name, worktree name, or path to resume (default: current worktree)

term: Option<String>

Terminal launch method for THIS invocation. Overrides config and CW_LAUNCH_METHOD. Accepts canonical names or aliases. Supports method:session-name for tmux/zellij.

Spawn

Launch AI tool in an existing worktree (default: current).

Fields

target: Option<String>

Worktree target — exact worktree name, branch name, or path. Default: current worktree.

term: Option<String>

Terminal launch method for THIS invocation. Overrides config and CW_LAUNCH_METHOD. Accepts canonical names or aliases. Supports method:session-name for tmux/zellij.

prompt: Option<String>

Initial prompt to pass to the AI tool.

prompt_file: Option<PathBuf>

Read the initial prompt from a file.

prompt_stdin: bool

Read the initial prompt from standard input.

Rm

Remove one or more worktrees.

With no arguments: removes the current worktree (must be inside one). With one or more positional targets: removes each of them; flags apply to every target. With -i: opens a multi-select UI.

Exits 0 on full success, 1 if the user cancelled at the confirmation prompt or in the interactive UI, 2 if any target could not be removed (not found, busy, or an error).

Fields

targets: Vec<String>

Branch names or paths of worktrees to remove. If empty and –interactive is not set, removes the current worktree.

interactive: bool

Interactive multi-select UI (mutually exclusive with positional targets)

dry_run: bool

Show what would be removed without removing

keep_branch: bool

Keep the branch (only remove worktree)

delete_remote: bool

Also delete the remote branch

force: bool

Force remove: also bypasses the busy-detection gate (skips the “worktree is in use” check and removes anyway)

no_force: bool

Don’t use –force flag

List

List all worktrees (rich, human-readable)

Ls

Print all worktrees as TSV (for scripts)

Columns: worktree_id, branch, status, age, repo_root, path

Doctor

Run diagnostics

Fields

session_start: bool

Hook-friendly mode: emit a single-line summary and exit 0.

quiet: bool

Suppress informational chatter; keep only the summary.

Upgrade

Check for updates / upgrade

Fields

yes: bool

Skip the confirmation prompt; required for non-TTY environments.

SetupClaude

Install Claude Code skill for worktree task delegation

ShellSetup

Interactive shell integration setup

Exec

Run cmd in one specific worktree.

Fields

target: String

Worktree name, branch name, or path.

cmd: Vec<String>

Command and args.

Run

Run cmd in every worktree in scope.

Fields

only: Option<String>

Glob filter on branch name or worktree directory basename (e.g. ‘feat-*’). Matches if either side does.

no_main: bool

Skip the main worktree.

jobs: usize

Parallel worktrees.

continue_on_error: bool

Continue past per-worktree failures.

cmd: Vec<String>

Command and args.

Guard

Hook helper: read a Claude Code hook payload from stdin (or a file) and decide whether to allow or block the inbound tool use. Exits 0 to allow; non-zero with stderr message to block.

Fields

tool_input: String

Path to read the hook payload from, or “-” for stdin.

Path

[Internal] Get worktree path for a branch

Fields

branch: Option<String>

Branch name

list_branches: bool

List branch names (for tab completion)

interactive: bool

Interactive worktree selection

ShellFunction

Generate shell function for gw-cd

Fields

shell: String

Shell type: bash, zsh, fish, or powershell

UpdateCache

Refresh update cache (background process)

CompleteTargets

[Internal] Print completion targets for the current repo (one per line)

SpawnAi

[Internal] Execute an AI tool spawn spec file

Fields

spec: Option<PathBuf>

Path to the JSON spawn spec. If omitted, resolves the most recent spec for the current worktree from <git-dir>/gw-spawn-last.json.

Trait Implementations

impl Debug for Commands

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FromArgMatches for Commands

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut<'b>( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Subcommand for Commands

fn augment_subcommands<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_subcommands_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

fn has_subcommand(__clap_name: &str) -> bool

Test whether Self can parse a specific subcommand