wt list

List worktrees and their status.

Shows uncommitted changes, divergence from the default branch and remote, and optional CI status and LLM summaries.

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 and LLM summaries are generated — the table displays instantly and columns fill 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      6814f02a  30m   Add API tests
^ main             ^⇅                         ⇡1  ⇣1  41ee0834  4d    Merge fix-auth: hardened to…
+ fix-auth         ↕|                ↑2  ↓1     |     b772e68b  5h    Add secure token storage

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

Include CI status, line diffs, and LLM summaries:

wt list --full
Branch       Status        HEAD±    main↕     main…±  Remote⇅  CI  Commit    Age   Message
@ feature-api  +   ↕⇡     +54   -5   ↑4  ↓1  +234  -24   ⇡3      ●   6814f02a  30m   Add API tests
^ main             ^⇅                                    ⇡1  ⇣1  ●   41ee0834  4d    Merge fix-au…
+ fix-auth         ↕|                ↑2  ↓1   +25  -11     |     ●   b772e68b  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      ●   6814f02a  30m   Add API tests
^ main             ^⇅                                    ⇡1  ⇣1  ●   41ee0834  4d    Merge fix-au…
+ fix-auth         ↕|                ↑2  ↓1   +25  -11     |     ●   b772e68b  5h    Add secure t…
  exp             /↕                 ↑2  ↓1  +137                    96379229  2d    Add GraphQL…
  wip             /↕                 ↑1  ↓1   +33                    b40716dc  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; remote-only branches (visible with --remotes) get CI status detection. Results are cached for 30-60 seconds; use wt config state to view or clear.

LLM summaries (experimental)

With --full, summary = true, and a commit.generation command configured, the Summary column shows an LLM-generated one-line description of each branch's changes relative to the default branch.

Disabled by default — when enabled, each branch's diff is sent to the configured LLM for summarization. Results are cached until the diff changes.

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:

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

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

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

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

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

# Branches without worktrees
wt list --format=json --branches | jq '.[] | select(.kind == "branch") | .branch'

# Worktrees ahead of remote (needs pushing)
wt list --format=json | jq '.[] | select(.remote.ahead > 0) | {branch, ahead: .remote.ahead}'

# Stale CI (local changes not reflected in CI)
wt list --format=json --full | jq '.[] | select(.ci.stale) | .branch'

Fields:

Commit object

working_tree object

main object

remote object

worktree object

ci object

main_state values

These values describe the relation to the default branch.

"is_main" "orphan" "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 switch — Switch worktrees or open interactive picker

Command reference

wt list - List worktrees and their status

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, diff analysis, and LLM summaries

      --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...
          Verbose output (-v: hooks, templates; -vv: debug report)