Enum Commands 

pub enum Commands {
    New {
        name: String,
        path: Option<String>,
        base: Option<String>,
        no_term: bool,
        term: Option<String>,
        bg: bool,
        prompt: Option<String>,
        prompt_file: Option<PathBuf>,
        prompt_stdin: bool,
    },
    Pr {
        branch: Option<String>,
        title: Option<String>,
        body: Option<String>,
        draft: bool,
        no_push: bool,
        worktree: bool,
        by_branch: bool,
    },
    Merge {
        branch: Option<String>,
        interactive: bool,
        dry_run: bool,
        push: bool,
        ai_merge: bool,
        worktree: bool,
    },
    Resume {
        branch: Option<String>,
        term: Option<String>,
        bg: bool,
        worktree: bool,
        by_branch: bool,
    },
    Shell {
        worktree: Option<String>,
        args: Vec<String>,
    },
    Status {
        cache: CacheControl,
    },
    Delete {
        target: Option<String>,
        keep_branch: bool,
        delete_remote: bool,
        force: bool,
        no_force: bool,
        worktree: bool,
        branch: bool,
    },
    List {
        cache: CacheControl,
    },
    Clean {
        cache: CacheControl,
        merged: bool,
        older_than: Option<u64>,
        interactive: bool,
        dry_run: bool,
        force: bool,
    },
    Tree {
        cache: CacheControl,
    },
    Stats {
        cache: CacheControl,
    },
    Diff {
        branch1: String,
        branch2: String,
        summary: bool,
        files: bool,
    },
    Sync {
        branch: Option<String>,
        all: bool,
        fetch_only: bool,
        ai_merge: bool,
        worktree: bool,
        by_branch: bool,
    },
    ChangeBase {
        new_base: String,
        branch: Option<String>,
        dry_run: bool,
        interactive: bool,
        worktree: bool,
        by_branch: bool,
    },
    Config {
        action: ConfigAction,
    },
    Backup {
        action: BackupAction,
    },
    Stash {
        action: StashAction,
    },
    Hook {
        action: HookAction,
    },
    Export {
        output: Option<String>,
    },
    Import {
        import_file: String,
        apply: bool,
    },
    Scan {
        dir: Option<PathBuf>,
    },
    Prune,
    Doctor,
    Upgrade,
    SetupClaude,
    ShellSetup,
    Path {
        branch: Option<String>,
        list_branches: bool,
        interactive: bool,
    },
    ShellFunction {
        shell: String,
    },
    ConfigKeys,
    UpdateCache,
    TermValues,
    PresetNames,
    HookEvents,
}

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 (e.g., tmux, iterm-tab, zellij)

bg: bool

Launch AI tool in background

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

Pr

Create GitHub Pull Request from worktree

Fields

branch: Option<String>

Branch name (default: current worktree branch)

title: Option<String>

PR title

body: Option<String>

PR body

draft: bool

Create as draft PR

no_push: bool

Skip pushing to remote

worktree: bool

Resolve target as worktree name (instead of branch)

by_branch: bool

Resolve target as branch name (instead of worktree)

Merge

Merge feature branch into base branch

Fields

branch: Option<String>

Branch name (default: current worktree branch)

interactive: bool

Interactive rebase

dry_run: bool

Dry run (show what would happen)

push: bool

Push to remote after merge

ai_merge: bool

Use AI to resolve merge conflicts

worktree: bool

Resolve target as worktree name (instead of branch)

Resume

Resume AI work in a worktree

Fields

branch: Option<String>

Branch name to resume (default: current worktree)

term: Option<String>

Terminal launch method

bg: bool

Launch AI tool in background

worktree: bool

Resolve target as worktree name (instead of branch)

by_branch: bool

Resolve target as branch name (instead of worktree)

Shell

Open interactive shell or execute command in a worktree

Fields

worktree: Option<String>

Worktree branch to shell into

args: Vec<String>

Command and arguments to execute

Status

Show current worktree status

Fields

cache: CacheControl

Delete

Delete a worktree

Fields

target: Option<String>

Branch name or path of worktree to delete (default: current worktree)

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 deletes anyway)

no_force: bool

Don’t use –force flag

worktree: bool

Resolve target as worktree name (instead of branch)

branch: bool

Resolve target as branch name (instead of worktree)

List

List all worktrees

Fields

cache: CacheControl

Clean

Batch cleanup of worktrees

Note: --no-cache only affects the interactive listing path inside clean (which calls get_worktree_status). Merge/age-based deletion logic in clean uses git directly and does not consult the PR cache.

Fields

cache: CacheControl

merged: bool

Delete worktrees for branches already merged to base

older_than: Option<u64>

Delete worktrees older than duration (e.g., 7, 30d, 2w, 1m)

interactive: bool

Interactive selection UI

dry_run: bool

Show what would be deleted without deleting

force: bool

Bypass the busy-detection gate: delete busy worktrees too (default: skip worktrees another session is using)

Tree

Display worktree hierarchy as a tree

Fields

cache: CacheControl

Stats

Show worktree statistics

Fields

cache: CacheControl

Diff

Compare two branches

Fields

branch1: String

First branch

branch2: String

Second branch

summary: bool

Show statistics only

files: bool

Show changed files only

Sync

Sync worktree with base branch

Fields

branch: Option<String>

Branch name (default: current worktree)

all: bool

Sync all worktrees

fetch_only: bool

Only fetch updates without rebasing

ai_merge: bool

Use AI to resolve merge conflicts

worktree: bool

Resolve target as worktree name (instead of branch)

by_branch: bool

Resolve target as branch name (instead of worktree)

ChangeBase

Change base branch for a worktree

Fields

new_base: String

New base branch

branch: Option<String>

Branch name (default: current worktree)

dry_run: bool

Dry run (show what would happen)

interactive: bool

Interactive rebase

worktree: bool

Resolve target as worktree name (instead of branch)

by_branch: bool

Resolve target as branch name (instead of worktree)

Config

Configuration management

Fields

action: ConfigAction

Backup

Backup and restore worktrees

Fields

action: BackupAction

Stash

Stash management (worktree-aware)

Fields

action: StashAction

Hook

Manage lifecycle hooks

Fields

action: HookAction

Export

Export worktree configuration to a file

Fields

output: Option<String>

Output file path

Import

Import worktree configuration from a file

Fields

import_file: String

Path to the configuration file to import

apply: bool

Apply the imported configuration (default: preview only)

Scan

Scan for repositories (global mode)

Fields

dir: Option<PathBuf>

Base directory to scan (default: home directory)

Prune

Clean up stale registry entries (global mode)

Doctor

Run diagnostics

Upgrade

Check for updates / upgrade

SetupClaude

Install Claude Code skill for worktree task delegation

ShellSetup

Interactive shell integration setup

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 / cw-cd

Fields

shell: String

Shell type: bash, zsh, fish, or powershell

ConfigKeys

List config keys (for tab completion)

UpdateCache

Refresh update cache (background process)

TermValues

List terminal launch method values (for tab completion)

PresetNames

List preset names (for tab completion)

HookEvents

List hook event names (for tab completion)

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