Skip to content

list

Lists all git worktrees with their tmux window status and merge status. Alias: ls

bash
workmux list [flags]

Options

FlagDescription
--prShow GitHub PR status for each worktree. Requires the gh CLI to be installed and authenticated. Note that it shows pull requests' statuses with Nerd Font icons, which requires Nerd Font compatible font installed.

Examples

bash
# List all worktrees
workmux list

# List with PR status
workmux list --pr

Example output

BRANCH      TMUX    UNMERGED    PATH
------      ----    --------    ----
main        -       -           ~/project
user-auth   ✓       -           ~/project__worktrees/user-auth
bug-fix     ✓       ●           ~/project__worktrees/bug-fix

Key

  • in TMUX column = tmux window exists for this worktree
  • in UNMERGED column = branch has commits not merged into main
  • - = not applicable

Released under the MIT License.