wt

wt list

List all git worktrees with their setup status.

Synopsis

wt list [options]

Description

wt list displays all git worktrees for the current repository in a tabular format, along with their dependency and env file status.

Options

OptionDescription
--jsonOutput as JSON (for scripting)
--statusShow per-worktree ecosystem and timing detail

Examples

wt list
wt list --status      # show ecosystems, env strategy, setup timestamp
wt list --json        # machine-readable output

Output Format

  BRANCH                          PATH                                  DEPS    ENV     STATUS
  ------------------------------------------------------------------------------------------------
> main                            /Users/dev/myapp                      ok      ok      ready
  shreyansh/feat-payments         /Users/dev/worktrees/myapp-feat-p...  ok      ok      ready

The > prefix marks your current working directory.

Status Values

StatusMeaning
readySetup completed successfully
partialSetup ran but one or more steps had warnings
failedSetup could not complete
pendingWorktree created but setup has not run yet
-Bare worktree or no status file

Exit Codes

CodeMeaning
0Always (list commands do not fail)

Previous

wt setup

Next

wt remove

On this page