lazyworktree

LazyWorktree

LazyWorktree is a terminal UI for managing Git worktrees with a keyboard-first workflow.

Work across multiple Git worktrees from one interface. Create, switch, remove, and run operations without changing directories.

Built with Bubble Tea, it shows worktree state and integrates with development tools, including tmux, zellij, and OCI runtimes such as Docker or Podman.

Screenshot

You can see more screenshots here

Main Features

• Worktree management - Create worktrees from branches, PRs/MRs, or issues; safely clean up merged worktrees without discarding uncommitted changes; delete, list, and switch between them
• CI & PR/MR status - See GitHub Actions and GitLab CI results, check PR/MR details, view logs and more.
• Agent sessions pane - See confirmed active Claude, Codex, Copilot, and pi sessions attached to the selected worktree.
• Command palette - Quick access to all actions and custom commands with ?.
• Tmux and Zellij support - Automatically open worktrees in new tmux windows/panes or zellij tabs
• Docker/Podman support - Run commands in Docker or Podman containers tied to the worktree
• Custom commands - Set up custom shell commands in config, bind them to keys, show them in the palette.
• Notes - Markdown notes per worktree to track work in progress
• Hooks - .wt files per worktree to automate setup and cleanup tasks
• Customise worktree metadata - Press e in the worktree pane to edit the description, colour, notes, icon, and tags for the selected worktree.
• Shell helpers - cd "$(lazyworktree)" shortcut and shell completion for bash, zsh, and fish (making it easy to jump to worktrees from the terminal)
• LLM-friendly CLI - Use doctor, describe, worktrees ..., and notes get to make it esay to manage wortrees with LLM agents.

Documentation

Primary documentation lives on the docs site:

• https://chmouel.github.io/lazyworktree/docs/

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:

• https://github.com/chmouel/lazyworktree/blob/main/shell/README.md

Requirements

• Git 2.31+
• Forge CLI (gh or glab) for PR/MR status

Optional tools are documented here:

• https://chmouel.github.io/lazyworktree/docs/getting-started/#requirements

Author

Chmouel Boudjnah

• Fediverse - <@chmouel@chmouel.com>
• Twitter - <@chmouel>
• Blog - <https://blog.chmouel.com>

Licence

Apache-2.0