chmouel/lazyworktree
chmouel/lazyworktree has 315 GitHub stars and 13 forks. GitHot measured -1 stars in 24 hours and -1 in 7 days. Last checked 2026-11-18 20:19 UTC. Last push 2026-11-02.
What you can do
- Worktree management: Create worktrees from branches, PRs/MRs, or issues; clean up merged worktrees without discarding uncommitted changes; list and switch between worktrees.
- CI and PR/MR status: View GitHub Actions and GitLab CI results, PR/MR details, and logs.
- Agent sessions pane: View confirmed active Claude, Codex, Copilot, and pi sessions attached to the selected worktree.
- Command palette: Press ? to open the palette for actions and custom commands.
Measured star growth
- in 24h
- -1
- in 7 days
- -1
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
Easy Git worktree management CLI and TUI for the terminal.
Developer ToolsREADME.md
Original
LazyWorktree
LazyWorktree is a keyboard-driven terminal UI for managing Git worktrees.Manage multiple Git worktrees from one interface: create, remove, and switch between them without navigating between directories.
Built with Bubble Tea, LazyWorktree shows worktree state and supports tmux, Zellij, Herdr, Docker, and Podman.
Screenshot

Main Features
- Worktree management: Create worktrees from branches, PRs/MRs, or issues; clean up merged worktrees without discarding uncommitted changes; list and switch between worktrees.
- CI and PR/MR status: View GitHub Actions and GitLab CI results, PR/MR details, and logs.
- Agent sessions pane: View confirmed active Claude, Codex, Copilot, and pi sessions attached to the selected worktree.
- Command palette: Press
?to open the palette for actions and custom commands. - Multiplexer support: Open worktrees in tmux windows or panes, Zellij tabs, or Herdr workspaces and sessions.
- Docker/Podman support: Run commands in containers for a worktree.
- Custom commands: Configure shell commands, bind them to keys, and list them in the palette.
- Notes: Keep Markdown notes for each worktree.
- Hooks: Automate worktree setup and cleanup with
.wtfiles. - Customise worktree metadata: Press
ein the worktree pane to edit the selected worktree's description, colour, notes, icon, and tags. - Shell helpers: Jump to a worktree with
cd "$(lazyworktree)". Completions are available for Bash, Zsh, and Fish. - LLM-friendly CLI: Use
doctor,describe,worktrees ..., andnotes getto help LLM agents inspect and manage worktrees.
Documentation
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/diagnostic-guide/
Installation
Homebrew (macOS)
brew tap chmouel/lazyworktree https://github.com/chmouel/lazyworktree
brew install lazyworktree --cask
Arch Linux
yay -S lazyworktree-bin
From source
go install github.com/chmouel/lazyworktree/cmd/lazyworktree@latest
Quick Start
cd /path/to/your/repository
lazyworktree
Shell Integration
To jump to the selected worktree from your shell:
cd "$(lazyworktree)"
For shell integration helpers, see:
Requirements
- Git 2.31+
- Forge CLI (
ghorglab) for PR/MR status
Optional tools are documented here:
Author
Chmouel Boudjnah
- Fediverse - <@[email protected]>
- Twitter - <@chmouel>
- Blog - <https://blog.chmouel.com>