The list command displays a text table of all worktrees in the current repository with their status, branch, current task, and tmux session information.
Usage
bash
owt list [OPTIONS]Alias: owt ls
Options
| Option | Description |
|---|---|
-a, --all | Show all worktrees including main |
Examples
Basic Usage
bash
owt listOutput:
┌──────────────────┬───────────────────┬──────────┬──────────────────────────┬──────────────────┐
│ Name │ Branch │ Status │ Current Task │ tmux Session │
├──────────────────┼───────────────────┼──────────┼──────────────────────────┼──────────────────┤
│ add-auth │ feature/add-auth │ working │ Implement JWT auth... │ owt-add-auth │
│ fix-nav │ bugfix/fix-nav │ idle │ Fix navigation crash │ owt-fix-nav │
│ api-v2 │ feature/api-v2 │ working │ Build REST endpoints │ owt-api-v2 │
└──────────────────┴───────────────────┴──────────┴──────────────────────────┴──────────────────┘Include Main Worktree
bash
owt list --allOutput:
┌──────────────────┬───────────────────┬──────────┬──────────────────────────┬──────────────────┐
│ Name │ Branch │ Status │ Current Task │ tmux Session │
├──────────────────┼───────────────────┼──────────┼──────────────────────────┼──────────────────┤
│ main │ main │ - │ - │ - │
│ add-auth │ feature/add-auth │ working │ Implement JWT auth... │ owt-add-auth │
│ fix-nav │ bugfix/fix-nav │ idle │ Fix navigation crash │ owt-fix-nav │
└──────────────────┴───────────────────┴──────────┴──────────────────────────┴──────────────────┘Columns
| Column | Description |
|---|---|
| Name | Worktree identifier |
| Branch | Git branch checked out in the worktree |
| Status | Current AI agent activity status |
| Current Task | The last task sent to the AI agent |
| tmux Session | Name of the associated tmux session |
See Also
owt(Control Plane) -- Visual worktree managerowt new-- Create new worktreesowt switch-- Jump to a worktree