​

LazyWorktree - Easy Git worktree management for the terminal

​

Key Features

​

Worktree Management

• Create, rename, remove, absorb, and prune merged worktrees
• VIM style keybinding and a VSCode-like command palette
• Filter and search across worktrees, files, and commits
• Simple per-worktree notes and todo editor with markdown support

​

Powerful Creation Options

• From current branch, optionally with uncommitted changes
• Checkout existing branch or create a new branch from it
• From GitHub/GitLab issue with automatic branch naming
• From open GitHub/GitLab PR or MR
• Custom creation menu items via configuration

​

Git Integration

• Stage, unstage, commit, edit, and diff files
• View diffs in a pager with optional delta integration
• Cherry-pick commits between worktrees
• Display linked PR/MR, CI status, and checks
• View CI logs from GitHub Actions

​

Session Management

• Manage per-worktree tmux or zellij sessions
• Shell integration: jump into worktrees and return to the last-used one
• Custom commands: define keybindings, tmux/zellij layouts, and per-repo workflows

​

Advanced Features

• Taskboard: view markdown checkbox tasks grouped by worktree
• Command palette with MRU-based navigation
• Init/terminate hooks via .wt files with TOFU security
• Automatic branch naming via scripts (e.g., LLM tools)
• Multiple themes with custom theme support

​

What are Git Worktrees?

• Work on multiple branches simultaneously
• Keep long-running feature branches in separate directories
• Review pull requests without disrupting your current work
• Run tests on one branch while developing on another

​

Why LazyWorktree?

• Fast: Built with Go and BubbleTea for instant startup and responsive UI
• Keyboard-driven: Complete control without leaving your keyboard
• Git-native: Tight integration with GitHub, GitLab, and CI systems
• Customizable: Extensive configuration options, custom commands, and themes
• Productive: Shell integration, session management, and automated workflows

​

Next Steps