Quick start
$ brew tap chmouel/lazyworktree https://github.com/chmouel/lazyworktree
$ brew install lazyworktree --cask
$ cd your-repository
$ lazyworktreeA TUI for git worktrees
A lazier way to manage worktrees.
LazyWorktree is a keyboard-first TUI for managing Git worktrees, branches, pull requests, and CI status. Each task gets its own worktree, so you never switch branches in a shared directory: tmux or zellij sessions, notes, TODO items, and uncommitted changes stay where you left them.
- Git 2.31+Supported baseline
- Keyboard-firstVim motions + command palette
- PR and CI awareGitHub and GitLab workflows
Features
What it does
Worktree management
Create, rename, remove, absorb, and prune merged worktrees directly from the keyboard.
Worktrees become the centre of your development cycle instead of branch checkouts in one directory. Terminal sessions, local notes, and Git state stay anchored to the worktree you're in.
- Create a new worktree in one keystroke.
- Remove worktrees safely; uncommitted changes are protected.
- Rename worktrees and keep paths organised.
Create from anything
Create from branch, commit, PR/MR, issue, or custom menu item with optional branch automation.
Start a new environment from any git reference without checking out branches or fetching commits by hand.
- Select a Pull Request or Merge Request to review code in isolation.
- Pick an Issue and start on the fix right away.
- Customise menu items for your own workflow automations.
Git operations
Stage, commit, diff, push, sync, and cherry-pick -- all from within the TUI.
Daily git tasks run inside the app. When you need more, press
G to jump into
lazygit.
- Stage and commit files.
- Review diffs before pushing.
- Keep everything up to date with one-keystroke sync.
CI checks
See check status, read logs, open job pages, and restart GitHub Actions runs.
CI pipelines sit alongside your code, so you can see whether tests passed without opening a browser.
- Works with GitHub Actions and GitLab CI.
- Read logs in the terminal.
- Restart failed jobs in place.
tmux / zellij sessions
Each worktree can get its own tmux or zellij session, with configurable prefixes.
Terminal multiplexers keep each worktree's workspace state separate.
- Spawn a new tmux or zellij session when entering a worktree.
- Rename sessions after the branch.
- Switching worktrees switches your session with it.
Hooks and custom commands
Run init and terminate hooks via .wt and add custom
command bindings.
Run setup and teardown tasks for every worktree you create or delete.
-
Run
npm installorgo mod downloadon creation. - Map custom keybindings to your own shell scripts.
Worktree notes
Attach markdown notes to any worktree and view them rendered in the info pane.
Attach a scratchpad to each worktree so you remember where you left off.
- Write notes in standard Markdown.
- Notes are saved per worktree and persist across reboots.
- Rendered in the info pane.
Taskboard
Turn markdown checkbox notes into a grouped Taskboard and toggle progress without leaving the TUI.
Markdown checkboxes in your notes become an interactive taskboard.
-
Use
- [ ] Tasksyntax in your worktree notes. - Toggle tasks as complete with a single keystroke.
- Tasks group by worktree.
Configuration
Set options via CLI flags, git config, or a YAML file. Local settings override global ones.
Three levels of settings: global config, per-repository overrides, and CLI flags. More specific wins.
-
Define global preferences in
~/.config/lazyworktree/config.yml. - Override specific settings per-repository using git config.
- Pass temporary overrides via CLI flags.
Install
Installation
brew tap chmouel/lazyworktree https://github.com/chmouel/lazyworktree
brew install lazyworktree --caskyay -S lazyworktree-bingo install github.com/chmouel/lazyworktree/cmd/lazyworktree@latest
Optional tools: gh or glab for forge data,
and delta for enhanced diffs.
Screenshots
Screenshots
Give it a go.
It's open source, installs in seconds, and works with any Git repo that uses worktrees.