wt list

Show all worktrees with their status. The table includes uncommitted changes, divergence from the default branch and remote, and optional CI status.

The table renders progressively: branch names, paths, and commit hashes appear immediately, then status, divergence, and other columns fill in as background git operations complete. With --full, CI status fetches from the network — the table displays instantly and CI fills in as results arrive.

Examples

List all worktrees:

$ wt list
  Branch       Status        HEAD±    main↕  Remote⇅  Commit    Age   Message
@ feature-api  +   ↕⇡     +54   -5   ↑4  ↓1   ⇡3      ec97decc  30m   Add API tests
^ main             ^⇅                         ⇡1  ⇣1  6088adb3  4d    Merge fix-auth: hardened to…
+ fix-auth         ↕|                ↑2  ↓1     |     127407de  5h    Add secure token storage

○ Showing 3 worktrees, 1 with changes, 2 ahead, 1 column hidden

Include CI status and line diffs:

$ wt list --full
  Branch       Status        HEAD±    main↕     main…±  Remote⇅  CI  Commit    Age   Message
@ feature-api  +   ↕⇡     +54   -5   ↑4  ↓1  +234  -24   ⇡3      ●   ec97decc  30m   Add API tests
^ main             ^⇅                                    ⇡1  ⇣1  ●   6088adb3  4d    Merge fix-au…
+ fix-auth         ↕|                ↑2  ↓1   +25  -11     |     ●   127407de  5h    Add secure t…

○ Showing 3 worktrees, 1 with changes, 2 ahead, 1 column hidden

Include branches that don't have worktrees:

$ wt list --branches --full
  Branch       Status        HEAD±    main↕     main…±  Remote⇅  CI  Commit    Age   Message
@ feature-api  +   ↕⇡     +54   -5   ↑4  ↓1  +234  -24   ⇡3      ●   ec97decc  30m   Add API tests
^ main             ^⇅                                    ⇡1  ⇣1  ●   6088adb3  4d    Merge fix-au…
+ fix-auth         ↕|                ↑2  ↓1   +25  -11     |     ●   127407de  5h    Add secure t…
  exp             /↕                 ↑2  ↓1  +137                    99e114de  2d    Add GraphQL…
  wip             /↕                 ↑1  ↓1   +33                    d62fd0e8  3d    Start API do…

○ Showing 3 worktrees, 2 branches, 1 with changes, 4 ahead, 1 column hidden

Output as JSON for scripting:

$ wt list --format=json

Columns

Note: main↕ and main…± refer to the default branch (header label stays main for compactness). main…± uses a merge-base (three-dot) diff.

CI status

The CI column shows GitHub/GitLab pipeline status:

CI indicators are clickable links to the PR or pipeline page. Any CI dot appears dimmed when there are unpushed local changes (stale status). PRs/MRs are checked first, then branch workflows/pipelines for branches with an upstream. Local-only branches show blank. Results are cached for 30-60 seconds; use wt config state to view or clear.

Status symbols

The Status column has multiple subcolumns. Within each, only the first matching symbol is shown (listed in priority order):

Rows are dimmed when safe to delete (_ same commit with clean working tree or ⊂ content integrated).

JSON output

Query structured data with --format=json:

# Worktrees with merge conflicts
wt list --format=json | jq '.[] | select(.operation_state == "conflicts")'

# Uncommitted changes
wt list --format=json | jq '.[] | select(.working_tree.modified)'

# Current worktree
wt list --format=json | jq '.[] | select(.is_current)'

# Branches ahead of the default branch
wt list --format=json | jq '.[] | select(.main.ahead > 0)'

# Integrated branches (ready to clean up)
wt list --format=json | jq '.[] | select(.main_state == "integrated" or .main_state == "empty")'

Fields:

commit object

working_tree object

main object

remote object

worktree object

ci object

main_state values

These values describe relation to the default branch.

"is_main" "would_conflict" "empty" "same_commit" "integrated" "diverged" "ahead" "behind"

integration_reason values

When main_state == "integrated": "ancestor" "trees_match" "no_added_changes" "merge_adds_nothing"

ci.status values

"passed" "running" "failed" "conflicts" "no-ci" "error"

Missing a field that would be generally useful? Open an issue.

See also

• wt select — Interactive worktree picker with live preview

Command reference

wt list - List worktrees and optionally branches

Usage: wt list [OPTIONS]
       wt list <COMMAND>

Commands:
  statusline  Single-line status for shell prompts

Options:
      --format <FORMAT>
          Output format (table, json)

          [default: table]

      --branches
          Include branches without worktrees

      --remotes
          Include remote branches

      --full
          Show CI, merge-base diffstat, and working tree conflict check

      --progressive
          Show fast info immediately, update with slow info

          Displays local data (branches, paths, status) first, then updates with
          remote data (CI, upstream) as it arrives. Auto-enabled for TTY.

  -h, --help
          Print help (see a summary with '-h')

Global Options:
  -C <path>
          Working directory for this command

      --config <path>
          User config file path

  -v, --verbose
          Show commands and debug info