CLI Flags Reference

This page is generated from internal/bootstrap/flags.go and internal/bootstrap/commands.go. Run make docs-sync after changing flag definitions.

Global Flags

Flag	Type	Usage
--config, -C	stringslice	Override config values (repeatable): --config=lw.key=value
--config-file	string	Path to configuration file
--debug-log	string	Path to debug log file
--output-selection	string	Write selected worktree path to a file
--search-auto-select	bool	Start with filter focused
--show-syntax-themes	bool	List available delta syntax themes
--theme, -t	string	Override the UI theme
--worktree-dir, -w	string	Override the default worktree root directory

Command Flags

list

Flag	Type	Usage
--json	bool	Output as JSON
--pristine, -p	bool	Output paths only (one per line, suitable for scripting)

create

Flag	Type	Usage
--exec, -x	string	Run a shell command after creation (in the created worktree, or current directory with --no-workspace)
--from-branch	string	Create worktree from branch (defaults to current branch)
--from-issue	int	Create worktree from issue number
--from-issue-interactive, -I	bool	Interactively select an issue to create worktree from
--from-pr	int	Create worktree from PR number
--from-pr-interactive, -P	bool	Interactively select a PR to create worktree from
--generate	bool	Generate name automatically from the current branch
--no-workspace, -N	bool	Create local branch and switch to it without creating a worktree (requires --from-pr, --from-pr-interactive, --from-issue, or --from-issue-interactive)
--output-selection	string	Write created worktree path to a file
--query, -q	string	Pre-filter interactive selection (pre-fills fzf search or filters numbered list); requires --from-pr-interactive or --from-issue-interactive
--silent	bool	Suppress progress messages
--with-change	bool	Carry over uncommitted changes to the new worktree

delete

Flag	Type	Usage
--no-branch	bool	Skip branch deletion
--silent	bool	Suppress progress messages

rename

Flag	Type	Usage
--silent	bool	Suppress progress messages

exec

Flag	Type	Usage
--key, -k	string	Custom command key to trigger (e.g. 't' for tmux)
--workspace, -w	string	Target worktree name or path

Validation Rules

These runtime rules are enforced in internal/bootstrap/commands.go:

• create: --from-pr, --from-issue, --from-pr-interactive, and --from-issue-interactive are mutually exclusive.
• create: --query requires --from-pr-interactive or --from-issue-interactive.
• create: --no-workspace requires PR/issue creation mode and cannot be combined with --with-change or --generate.
• list: --pristine and --json are mutually exclusive.
• exec: use either positional command or --key, never both.