LazyWorktree is a terminal UI for managing Git worktrees with a keyboard-first workflow.
Built with BubbleTea, it focuses on fast iteration, clear state visibility, and tight Git tooling integration.
Primary documentation lives on the docs site:
Useful entry points:
- Introduction: https://chmouel.github.io/lazyworktree/docs/
- Getting started: https://chmouel.github.io/lazyworktree/docs/getting-started/
- Core workflows: https://chmouel.github.io/lazyworktree/docs/core/worktree-operations/
- Navigation and keybindings: https://chmouel.github.io/lazyworktree/docs/core/navigation-and-keybindings/
- Configuration overview: https://chmouel.github.io/lazyworktree/docs/configuration/overview/
- Configuration reference: https://chmouel.github.io/lazyworktree/docs/configuration/reference/
- Full configuration example:
config.example.yaml - CLI overview: https://chmouel.github.io/lazyworktree/docs/cli/overview/
- CLI flags reference: https://chmouel.github.io/lazyworktree/docs/cli/flags/
- CLI commands reference: https://chmouel.github.io/lazyworktree/docs/cli/commands/
- Troubleshooting: https://chmouel.github.io/lazyworktree/docs/troubleshooting/common-problems/
You can see more screenshots here
brew tap chmouel/lazyworktree http://github.com/chmouel/lazyworktree
brew install lazyworktree --caskyay -S lazyworktree-bingo install github.com/chmouel/lazyworktree/cmd/lazyworktree@latestcd /path/to/your/repository
lazyworktreeTo jump to the selected worktree from your shell:
cd "$(lazyworktree)"For shell integration helpers, see:
- Git 2.31+
- Forge CLI (
ghorglab) for PR/MR status
Optional tools are documented here:
Build the binary:
make buildRun full checks:
make sanityPreview docs locally:
brew install uv # if not already installed
make docs-serveBuild docs locally:
make docs-buildSynchronise generated docs references:
make docs-syncRun docs synchronisation and strict docs checks:
make docs-check