NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules
Go modules, #2998 by repository stars
Latest stable
v1.52.0
Last release 20 days ago
02 Nov 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 59 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
10 months old
127 releases · first in 2025
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Nothing published for this version
This release introduces deeper integration with the Herdr multiplexer, enabling worktree creation directly within Herdr, automatic workspace grouping
This release introduces deeper integration with the Herdr multiplexer, enabling worktree creation directly within Herdr, automatic workspace grouping under repositories, and workspace cleanup on worktree deletion. It also improves existing branch and worktree handling when creating from issues, honors background settings for multiplexer sessions, and hardens test isolation.
<img width="3804" height="2098" alt="image" src="https://github.com/user-attachments/assets/eaeb2e3a-8d5e-4006-be81-635da6ae07ea" />
use_herdr_for_workspace_create and herdr_workspace_create_layout configuration options, allowing Herdr to create new worktrees as workspaces grouped under their repository across the CLI, TUI, and shell helpers.herdr worktree open. This can be toggled via the new worktree_group field on custom commands (defaults to true).lazyworktree delete, or lazyworktree cleanup now closes associated Herdr workspaces across all running sessions, while preserving the workspace hosting LazyWorktree itself..wt files on new worktrees now includes a "Cancel Setup" option, which retains the worktree while skipping initialization commands and workspace layout execution.--from-issue / -I) instead of failing with a branch-already-exists error.git worktree prune.--no-workspace.attach: false configurations for tmux and Zellij when running through CLI exec, launching sessions in the background and printing attach instructions rather than attaching interactively.new_tab.bash -l to resolve quote rewriting and multi-line command issues in interactive shells.github.com/charmbracelet/ultraviolet.Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
Nothing published for this version
This release introduces support for the Herdr multiplexer, implements worktree tracking for multiplexer sessions, adds interactive branch checkout and
This release introduces support for the Herdr multiplexer, implements worktree tracking for multiplexer sessions, adds interactive branch checkout and sync improvements, and enhances safety during worktree updates.
exec support, and a default H keybinding.[worktree] and highlighted in green within the -P (pull request) and -I (issue) interactive selectors.create command can now check out an existing local or remote-tracking branch directly when no explicit worktree name is specified, falling back to a generated branch name if already in use.git rebase and git reset --hard commands when existing worktrees cannot be updated due to divergent history.--update-on-existing to safely fast-forward clean worktrees to the latest upstream commit rather than performing hard resets, leaving dirty, ahead, or diverged worktrees intact.on_exists: kill from terminating unrelated untagged sessions sharing the same name.new_tab Multiplexer Handling: Allowed tmux and zellij custom commands configured with new_tab to execute in CLI mode by attaching within the active terminal rather than failing.sh when bash is missing, and preserved existing panes when tabs specify no custom command.README.md for clarity and consistency (#104).charm.land/bubbletea/v2 to v2.1.0.github.com/urfave/cli/v3 to v3.14.0.golang.org/x/sys, golang.org/x/term, golang.org/x/sync, and other indirect dependencies to their latest versions.Nothing published for this version
This release resolves an issue preventing Homebrew cask updates during automated releases, updates the Go toolchain to 1.26, and updates project depen
This release resolves an issue preventing Homebrew cask updates during automated releases, updates the Go toolchain to 1.26, and updates project dependencies.
github.com/urfave/cli/v3 to v3.13.0.testify, golang.org/x/sys, and golang.org/x/term.Nothing published for this version
This release adds PR and MR reviewer details directly to the Info pane, improves cleanup safety by automatically skipping worktrees with uncommitted c
This release adds PR and MR reviewer details directly to the Info pane, improves cleanup safety by automatically skipping worktrees with uncommitted changes, expands the random branch name generator, and fixes text pasting across modal inputs.
<img width="2250" height="378" alt="image" src="https://github.com/user-attachments/assets/f67406bc-bead-4c56-9cf3-4799db75f5a6" />
pr_reviewers: auto|never.cleanup commands now skip worktrees containing uncommitted changes, untracked files, or dirty submodules to prevent data loss (#98). Skipped items and their reasons are reported in CLI summaries and --json output.gemini-3.5-flash-lite and gemini-3.6-flash..golangci.yml.actions/setup-go to v7.alexellis/setup-arkade to v4.charm.land/bubbles, charm.land/bubbletea, and charm.land/lipgloss.Nothing published for this version
Nothing published for this version
Nothing published for this version
This release introduces precise AI agent session tracking with lifecycle hooks, a new CLI cleanup command for stale worktrees, and customizable CI rem
This release introduces precise AI agent session tracking with lifecycle hooks, a new CLI cleanup command for stale worktrees, and customizable CI remote targeting. It also significantly reduces idle CPU consumption and hardens concurrent worktree note editing.
[!NOTE] Run
lazyworktree setup-hooksto migrate to the new LLM session detection
lazyworktree setup-hooks to install.cleanup CLI subcommand to identify and remove merged worktrees, stale branches, and orphaned directories. Users can run this interactively or automate it non-interactively using the --all flag.--json flag into the cleanup command to emit machine-readable results, and updated the command's visual summary to display a bulleted list of removed worktrees.ci_remote setting (with an "auto" sentinel) to target a specific remote (such as upstream) for GitHub CI and PR status queries. This ensures fork workflows query the upstream repository without changing the worktree's core local repository identity.GIT_OPTIONAL_LOCKS=0 into executed Git commands to prevent concurrent automated operations from performing optional index locks, eliminating index modification conflicts.LAZYWORKTREE_PPROF CPU profiling hook.AGENTS.md for better visibility of README.md modification constraints.golang.org/x/term, golang.org/x/sync, golang.org/x/sys) via weekly maintenance (PR #82)charm.land Bubble Tea libraries (bubbles, bubbletea, lipgloss) and ultraviolet (PR #77, PR #83)This release introduces significant performance optimizations to eliminate idle CPU usage, adds a new clean-reset option for existing worktrees, and b
<img width="1434" height="1575" alt="image" src="https://github.com/user-attachments/assets/2b4aeb78-8465-4916-bcbc-e7b6099ed3a1" />
GitHub avatar Badges
This release introduces significant performance optimizations to eliminate idle CPU usage, adds a new clean-reset option for existing worktrees, and brings several user-experience enhancements including Kitty-compatible avatar badges and hyperlinked repository headers.
--update-on-existing (-U) flag to the create command to automatically fetch and hard-reset an existing clean worktree to its remote head instead of failing.avatar_badges configuration.WORKTREE_*, REPO_*, and contextual LAZYWORKTREE_* variables.--debug-log command-line flag to configure debug logging dynamically to a file for easier troubleshooting of interactive selectors.cache-clear action to empty in-memory/on-disk caches and assigned the p key to fetch PR data separately without triggering full UI refreshes.agent_sessions.refresh_debounce_ms) to lower CPU usage when agents are actively writing.AGENTS.md requiring AI agents to clearly disclose their involvement, toolsets, and model configurations in pull requests or issues.Makefile and added confirmation messages on successful build completion.!) executes shell commands, and revised feature descriptions for clarity.actions/checkout from v6 to v7.github.com/urfave/cli/v3 from 3.10.0 to 3.10.1.None.
Nothing published for this version
This release introduces inline status chips for CI checks, dedicated PR status badges within the Info pane, and improved container execution logic for
This release introduces inline status chips for CI checks, dedicated PR status badges within the Info pane, and improved container execution logic for custom commands. Additionally, it features structural code refactoring, streamlined documentation, and various dependency upgrades to enhance overall stability.
screenshot of new pills <img width="3840" height="2088" alt="image" src="https://github.com/user-attachments/assets/744d2893-9468-403f-ae14-85955c233aa7" />
Open, Merged, Closed, Draft) directly to the Info pane for improved visibility of pull/merge request status.docs-drift-review) to systematically analyze repository documentation for implementation drift, stale examples, or clarity issues.sh -c) to prevent execution failures in container runtimes, and environment variables are properly expanded before execution.delta syntax theme arguments during CLI overrides.Model state fields into dedicated sub-structs (loadingState, detailsState, pendingOpState) to improve long-term codebase maintainability.refresh_interval to 10 seconds, disabled ci_auto_refresh by default, mapped the manual refresh key to r, and introduced the LAZYWORKTREE_DESCRIPTION variable for notes scripts.charm.land/bubbletea/v2 to v2.0.7 (Pull Request #66)charm.land/lipgloss/v2 to v2.0.4 (Pull Request #67)github.com/urfave/cli/v3 to v3.10.0 (Pull Request #67)golang.org/x/term to v0.44.0 (Pull Request #67)github.com/charmbracelet/ultraviolet to newer maintenance snapshots (Pull Requests #66, #67, #68)Nothing published for this version
This release introduces an alternative F1 shortcut for the command palette, a complete visual redesign of the website and documentation using a modern
This release introduces an alternative F1 shortcut for the command palette, a complete visual redesign of the website and documentation using a modern blue color palette, and key bug fixes for path expansion.
~other/worktrees) while still expanding home directory prefixes (~/).F1 as an alternative shortcut to open the command palette alongside the existing : and Ctrl+P bindings.agent_sessions, layout_sizes, and worktree_note_type keys.gemini-3.5-flash model.golang.org/x/sys, github.com/mattn/go-runewidth, and github.com/charmbracelet/ultraviolet (#62).None.
Nothing published for this version
CI/CD: Replaced deprecated GitHub Actions and optimized caching for setup-uv.
This release introduces an enhanced AI agent session tracking model with liveness classification and a suite of machine-readable CLI commands designed for stable automation and LLM integration.
active, recent, suspect, inactive) and source attribution (e.g., exact_file, cwd_heuristic).doctor: Reports repository, tool, and configuration health.worktrees resolve: Canonicalizes worktree names, branches, or paths.worktrees context: Provides combined note and agent session data for a specific worktree.notes get: Retrieves structured note metadata.describe: Emits the CLI command structure as JSON for introspection.feature vs feature-2) from being misidentified.-z) for untracked files and symlink helpers to correctly handle filenames containing spaces.DESIGN.md architecture note.setup-uv.urfave/cli/v3, fsnotify, golang.org/x/term, and ultraviolet. (#59, #61)This release introduces repo-local worktree placement using the new $LWT_REPO_PATH variable, adds the ability to prune merged branches without active
This release introduces repo-local worktree placement using the new $LWT_REPO_PATH variable, adds the ability to prune merged branches without active worktrees, and improves repository path resolution with URL decoding.
$LWT_REPO_PATH environment variable. This allows users to store worktrees within the repository itself (e.g., in a .worktrees folder) while automatically omitting redundant repository name segments.prune_stale_branches, which includes merged local branches that no longer have active worktrees in the prune checklist.%20) were not decoded before creating directory paths (#49).exec keyword in shell command wrappers.go.mod and go.sum) are updated.lw.worktree-dir now correctly maps to worktree_dir).bubbletea, lipgloss, bubbles, ultraviolet) and standard Go modules (x/term, x/sys). (#43, #45, #48)actions/configure-pages, actions/deploy-pages, actions/upload-pages-artifact, and peter-evans/create-pull-request. (#42)None.
Nothing published for this version
This release introduces support for agent tool approval states and includes significant internal architectural refactoring to improve code maintainabi
This release introduces support for agent tool approval states and includes significant internal architectural refactoring to improve code maintainability across the Git service and application handlers.
Nothing published for this version
It also includes an important breaking change to action IDs for keybinding configurations to prevent pane collisions and make configurations self-docu…
This release introduces a unified worktree metadata menu, comprehensive JSON output support for CLI commands to aid automation, and improved browser integrations. It also includes an important breaking change to action IDs for keybinding configurations to prevent pane collisions and make configurations self-documenting.
<img width="1756" height="1129" alt="image" src="https://github.com/user-attachments/assets/86c278e7-ff42-4844-9a5d-5c1d0e9c24a5" />
e in the worktree pane) to easily edit a worktree's description, colour, notes, icon, and tags from a single interface.describe command to output the CLI command structure as machine-readable JSON, enabling coding agents and external scripts to discover available commands programmatically.--json flag to create, delete, rename, exec, and note show commands for structured, machine-readable output.list Command: The list --json output now includes worktree notes and agent session metadata. Added a --no-agent flag to omit agent data for faster script execution.--exec-mode flag for create --exec to control shell invocation (login-shell, shell, or direct).o in the logs pane now opens the selected commit in the browser. When opening a worktree in the browser without an active Pull Request, the application now smartly falls back to opening the current branch page on GitHub or GitLab.worktree-create, git-diff, nav-filter) to eliminate cross-pane collisions.worktree-manage to worktree-manager for consistency.config.yaml using the old bare action IDs (e.g., create, diff, lazygit), you must update them to use the new prefixed names (e.g., worktree-create, git-diff, git-lazygit). Please refer to the Action IDs Reference documentation for the complete list of new names.Nothing published for this version
This release introduces a powerful new Agent Sessions pane to monitor AI assistant activity (Claude and Pi) directly within your worktrees. It also br
This release introduces a powerful new Agent Sessions pane to monitor AI assistant activity (Claude and Pi) directly within your worktrees. It also brings extensive organizational tools including worktree tagging, descriptions, curated icons, and a highly customizable pane-scoped keybinding system.
<img width="1865" height="1242" alt="screenshot-agent-sessions" src="https://github.com/user-attachments/assets/83285c34-6be6-4358-a7e0-9634ced789c7" />
tag:<name>).worktrees, status, log) or apply them globally using the universal key.docs-sync pre-commit check to automatically parse the command registry and keep docs/action-ids.md up to date.Makefile image optimization script to overwrite files in place directly and improve verbose output.Nothing published for this version
This release introduces a powerful new interactive commit screen, extensive enhancements to worktree notes (including a new CLI command and split mark
This release introduces a powerful new interactive commit screen, extensive enhancements to worktree notes (including a new CLI command and split markdown storage), custom worktree coloring, and major improvements to the command palette's search relevance.
Ctrl+G. It features separate fields for subject and body, support for external editors (Ctrl+X), and an option to auto-generate commit messages from staged diffs (Ctrl+O).lazyworktree note show and note edit CLI commands, allowing you to view, pipe, or modify worktree notes directly from the terminal without opening the TUI.worktree_note_type: splitted configuration. Instead of a single JSON file, notes can now be stored as individual markdown files with YAML frontmatter, utilizing customizable template paths for better interoperability with external tools._, keeping your keyboard shortcuts and footer hints clutter-free.↑ for unpushed, ★ for unmerged) and assigns deterministic, color-coded highlights to different commit authors.options field, allowing for arbitrary volume flags such as z or Z for SELinux relabeling.diff_refs.head_sha fallbacks.Ctrl+G (Commit) shortcut hint whenever the active worktree contains local changes.hack/sample-repo.sh script to automatically scaffold a rich Git repository with branches, commits, and worktrees to accelerate local testing.pngquant and jpegoptim) into the build pipeline to shrink website assets.github.com/google/shlex to safely parse user-defined shell commands for the new auto-generated commit message feature.Nothing published for this version
This release introduces powerful OCI container execution for custom commands, custom worktree icons via the command palette, a new --main flag for lis
This release introduces powerful OCI container execution for custom commands, custom worktree icons via the command palette, a new --main flag for listing worktrees, and significant improvements to PR branch tracking and worktree checkout logic.
/workspace, custom args, entrypoint overrides, interactive mode (-it flags), environment variable forwarding, and seamless integration with tmux and zellij.I keybinding.--main (-m) flag to lazyworktree list to filter and output only the primary worktree. Returns a single, clean object when combined with the --json flag.worktree_go_main zsh/shell helper function to quickly jump to the main repository directory..worktrees/ to the ignore file to prevent tracking local git worktree metadata.Nothing published for this version
This release brings major performance optimizations to PR fetching and UI rendering, introduces highly customizable pane layouts, and launches a compl
This release brings major performance optimizations to PR fetching and UI rendering, introduces highly customizable pane layouts, and launches a completely overhauled documentation website.
layout_sizes configuration option to define relative size weights for individual panes (worktrees, info, git status, commit, notes). You can now also dynamically shrink or grow the worktree pane at runtime using the h and l keys.= keybinding behavior).<img width="3730" height="2484" alt="image" src="https://github.com/user-attachments/assets/b97a1ce6-6ce6-453b-a992-33369bb08b3e" />
less pager flags (-swMQcR) to ensure better word wrapping and a cleaner, quieter output experience.SKILL.md dynamic commands that were causing permission check failures.ls-files for untracked file enumeration instead of parsing the heavier git status --porcelain output.docsync tool to automatically guarantee that CLI flags, command arguments, and YAML configuration references remain perfectly synced between the Go source code and the documentation site.Nothing published for this version
This release introduces a new feature to edit worktree notes in an external editor and includes a crucial bug fix for child process execution on macOS
This release introduces a new feature to edit worktree notes in an external editor and includes a crucial bug fix for child process execution on macOS.
Ctrl+X keybinding. The UI, help screens, and documentation have been updated to reflect this new capability.os.Stdin) behavior for bubbletea v2. This resolves an issue where child processes (such as shell commands, lazygit, and editors) would fail with a /dev/tty error on macOS (#25).Nothing published for this version
This release introduces major layout enhancements, including new dedicated panes for Worktree Notes, Repository Info, and Git Status. It also brings s
This release introduces major layout enhancements, including new dedicated panes for Worktree Notes, Repository Info, and Git Status. It also brings significant UI and UX improvements with an underlying migration to Bubble Tea v2, context-aware clipboard support, dynamic Zellij multiplexer workflows, and interactive query filtering.
<img width="3837" height="2128" alt="image" src="https://github.com/user-attachments/assets/39e226b5-c5ac-4879-9e71-8e0ac3ef3a13" />
n and p.new-pane flow. Users can now interactively pick target sessions and split directions (right/down) when opening sessions inside or outside of Zellij. Exited sessions are also now correctly filtered out.y to copy the context-relevant worktree path, file path, or commit SHA. Press Y to copy the selected worktree's branch name.-q / --query flag to the create command to pre-filter interactive Pull Request (-P) and Issue (-I) selection lists.README.md to fix broken screenshot links and reflect the new layout and keybindings.charm.land/bubbletea/v2, charm.land/bubbles/v2, charm.land/lipgloss/v2).MouseClickMsg and MouseWheelMsg handlers and updated keypress detection to align with Bubble Tea v2 standards.renderPaneBlock function.ColorProfileMsg) to assist in debugging display issues on constrained terminals.gofumpt formatting and removed unused constants.goreleaser/goreleaser-action from v6 to v7.x/ansi, x/term, lipgloss) to complement the Bubble Tea v2 upgrade.Nothing published for this version
This release fixes worktree directory creation to properly use the org/repo layout and introduces several UI rendering improvements to preserve box bo
This release fixes worktree directory creation to properly use the org/repo layout and introduces several UI rendering improvements to preserve box borders during modal popups. It also includes routine repository maintenance and an update to the Homebrew cask.
<worktree-dir>/<org>/<repo>/<name> directory layout for worktrees created via the TUI, replacing the previous flat path structure (#17).lipgloss styling instead of manual string repetition..omc/ internal state files and adding them to .gitignore.v1.38.0 and update the test coverage badge in the README.Nothing published for this version
This release introduces the ability to quickly rename the current worktree with a single command argument and adds support for opening multiplexer ses
This release introduces the ability to quickly rename the current worktree with a single command argument and adds support for opening multiplexer sessions in new terminal tabs. It also includes UI refinements and improvements to the internal test suite.
new_tab: true with tmux or zellij custom commands. This allows users to launch multiplexer sessions in new terminal tabs (Kitty, WezTerm, or iTerm) rather than suspending the TUI.rename command now supports a single-argument mode (lazyworktree rename <new-name>). When provided with only one argument, it will automatically detect and rename the worktree associated with the current working directory.internal/app package to use a mocked git worktree list --porcelain command, eliminating the need for a real Git repository setup and improving test reliability.gemini-3.1-pro-preview model.Nothing published for this version
This release introduces contextual tips to the loading screen to assist users during long-running operations and stabilizes the worktree list sorting
This release introduces contextual tips to the loading screen to assist users during long-running operations and stabilizes the worktree list sorting behavior. It also includes improvements to search navigation and updates to shell integration documentation for better dynamic path resolution.
n/N search traversal to built-in keys. This allows the letter 'n' to be typed normally into search queries, while still enabling next/previous match navigation after confirming a search with Enter.git rev-parse --show-toplevel. This allows for dynamic repository path resolution in aliases (Bash, Zsh, Fish) rather than relying on hardcoded paths.Nothing published for this version
Legacy Aliases: Removed deprecated CLI aliases wt-create, wt-rename, and wt-delete.
This release introduces a powerful new Taskboard for managing worktree-specific to-dos, a dedicated note viewer with external editor support, and significant CLI enhancements including exec and rename commands.
T): Introduced a Kanban-lite view to manage tasks across all worktrees.
- [ ] task) and TODO/DONE keywords from worktree notes.a.Space or Enter.f.i now opens a read-only viewer if a note exists (supporting vim-like navigation), or the editor if empty.$EDITOR) by pressing E in the viewer.worktree_notes_path configuration to store all notes in a single JSON file using repo-relative keys, facilitating synchronization across machines. Includes automatic migration for existing per-repo notes.exec command: Run arbitrary commands inside a specific worktree from the CLI (e.g., lazyworktree exec -w feature "npm test"). Supports auto-detection of the worktree from the current directory.rename command: Added a dedicated rename subcommand to rename worktrees (and their branches if names match) from the CLI.--exec flag to the create command to run setup scripts immediately after worktree creation.rename and delete subcommands.wt-create, wt-rename, and wt-delete.Nothing published for this version
This release brings a significant overhaul to worktree notes with Markdown rendering, keyword highlighting, and automation hooks, alongside improvemen
This release brings a significant overhaul to worktree notes with Markdown rendering, keyword highlighting, and automation hooks, alongside improvements to PR worktree naming and the command palette UI.
TODO, FIXME, WARN, NOTE, and TEST are now emphasized with icons and colors in the Info pane.worktree_note_script configuration. This allows you to hook into tools (like LLMs) to automatically generate implementation notes based on the PR or Issue content when creating a worktree.pr_branch_name_template to customize how worktree directories are named when creating from Pull Requests.branch_name_script to support generating titles for PRs.▶ and adjusted its coloring for better visibility.aichat to the list of recommended tools in the README for generating branch names and notes.Nothing published for this version
This release introduces a new configurable pane layout, adds the ability to annotate worktrees with personal notes, and improves terminal integration
This release introduces a new configurable pane layout, adds the ability to annotate worktrees with personal notes, and improves terminal integration with clickable PR numbers.
L.config.yaml with layout: top (default is layout: default).i on a selected worktree to open the editor.✎ or [N]) in the list.lumen) were not receiving the correct commit range. Commands now correctly use the SHA^..SHA format for commit diffs.Nothing published for this version
35f72ff9448e63113079c045195865c4145c43c8: feat: Add interactive PR selection for worktree creation (@chmouel)
Nothing published for this version
a4a6285507388d775173b35913df0a5d0883a716: feat: Add icons and shortcuts to command palette (@chmouel)
Nothing published for this version
98037fe58f22dcd4b97f0123f2b6a29eba523a9e: feat: Add WezTerm support for new terminal tabs (@chmouel)
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per month.