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. Work with isolated worktrees as your default workflow, eliminating the need to switch branches in a single directory. Each task gets its own worktree, keeping tmux or zellij sessions, local files, pull/merge requests, notes, TODO items, and Git state isolated and independent.
- 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.
Instead of constantly checking out branches in a single directory, you treat worktrees as the true center of your development cycle. Your terminal sessions, local notes, and Git operations remain completely undisturbed and anchored to the specific worktree you're in.
- Create a new worktree instantly.
- Remove worktrees safely, knowing uncommitted changes are protected.
- Rename your worktrees and keep paths organized.
Create from anything
Create from branch, commit, PR/MR, issue, or custom menu item with optional branch automation.
LazyWorktree allows you to instantiate a new environment based on any git reference. Forget manually checking out branches or fetching commits.
- Select a Pull Request or Merge Request to review code in isolation.
- Pick an Issue to instantly start working on a bug fix or feature.
- Customize menu items for highly specific workflow automations.
Git operations
Stage, commit, diff, push, sync, and cherry-pick -- all from within the TUI.
You don't need to leave the app to perform your daily git tasks. Enjoy a fast, responsive interface for managing your changes. If you need the extra power you can reach for the `G` key to start the OG of the lazy, [lazygit](https://github.com/jesseduffield/lazygit).
- Stage and commit files seamlessly.
- View detailed 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.
Monitor your continuous integration pipelines directly alongside your code. Never wonder if your tests passed again.
- Native integration with GitHub Actions and GitLab CI.
- Stream logs directly in your terminal.
- Quickly restart failed jobs without opening a browser.
tmux / zellij sessions
Each worktree can get its own tmux or zellij session, with configurable prefixes.
Supercharge your multitasking. LazyWorktree integrates perfectly with terminal multiplexers to isolate your workspace state.
- Automatically spawn a new tmux or zellij session when entering a worktree.
- Automatically rename sessions based on the branch.
- Switching between worktrees seamlessly switches your session.
Hooks and custom commands
Run init and terminate hooks via .wt and add custom
command bindings.
Tailor the tool to your exact workflow. Automate setup and teardown tasks for every worktree you create or destroy.
-
Automatically run
npm installorgo mod download. - Map custom keybindings to execute your own shell scripts.
Worktree notes
Attach markdown notes to any worktree and view them rendered in the info pane.
Keep your context exactly where you need it. Attach a scratchpad to your worktree so you never forget where you left off.
- Write notes in standard Markdown.
- Notes are saved per-worktree and persist across reboots.
- Beautifully rendered directly in the user interface.
Taskboard
Turn markdown checkbox notes into a grouped Taskboard and toggle progress without leaving the TUI.
Manage your to-do lists within your terminal. Convert simple markdown checkboxes into an interactive taskboard.
-
Use
- [ ] Tasksyntax in your worktree notes. - Toggle tasks as complete with a single keystroke.
- Track your progress visually.
Configuration
Set options via CLI flags, git config, or a YAML file. Local settings override global ones.
Configure LazyWorktree to behave exactly how you want. Flexible configuration hierarchy ensures the right settings apply.
-
Define global preferences in
~/.config/lazyworktree/config.yml. - Override specific settings per-repository using git config.
- Pass temporary overrides via CLI flags.
Install
Get running in less than one minute.
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
What it looks like
Give it a go.
It's open source, installs in seconds, and works with any Git repo that uses worktrees.