README
¶
git-worktree-tui
A minimal, keyboard-first TUI for Git worktrees built with Bubble Tea. List, create, open in your editor, and delete worktrees — without leaving your terminal.
Quick keys
| Context | Key | Action |
|---|---|---|
| Worktree picker | ↑/↓ or j/k |
Move selection |
| Worktree picker | a |
Add new worktree (open branch picker) |
| Worktree picker | d |
Delete selected worktree (inline confirm) |
| Worktree picker | Enter |
Open selected worktree in $VISUAL/$EDITOR or confirm delete |
| Worktree picker | r |
Refresh worktrees |
| Worktree picker | Esc |
Cancel delete confirmation |
| Branch picker | n |
Create new branch (inline input) |
| Branch picker | Enter |
Select branch / create new branch and worktree |
| Branch picker | Esc |
Back to list |
| List | q or Ctrl+C |
Quit |
| Anywhere | Ctrl+C |
Quit |
Tip: The help footer updates based on what you can do at the moment.
Features
- 📂 List existing worktrees with branch and path info
- ➕ Create a worktree from a local or remote branch
- 🌱 Create a brand‑new branch and worktree in one step
- 📝 Open the selected worktree in your
$VISUAL/$EDITORwith Enter
Install
Install with Go:
go install github.com/fredrikmwold/git-worktree-tui/cmd/worktree-tui@latest
Or download a prebuilt binary from the Releases page and place it on your PATH:
Directories
Click to show internal directories.
Click to hide internal directories.