Release Notes
Improved
-
PyPI wheels (experimental): releases publish
worktrunkto PyPI as platform wheels holding the same binaries as GitHub Releases, souv tool install worktrunkorpip install worktrunkinstallswtandgit-wt, anduvx --from worktrunk wtruns it without installing. (#4823, thanks @fresh2dev for #4822) -
Editor schemas for config files: JSON Schemas for user and project config are published under
worktrunk.dev/schema/. A#:schemaline at the top of a config file lets Taplo and Tombi complete keys and flag misspelled ones. Docs (#4726, thanks @FlavioAmurrioCS) -
Claude Code plugin install needs Claude Code 2.1.292:
wt config plugins claude installand the docs useclaude plugin install worktrunk --marketplace max-sixty/worktrunk, which adds the marketplace when it's missing and which older Claude Code rejects. Docs (#4843) -
Retry hint after failed setup: when
pre-startfails aswt switchcreates a worktree, the error suggests awt hook pre-startcommand that reruns setup there with the switch's variables. The old--no-hookshint led to "branch already exists", or to a worktree whose setup never ran. (#4705, thanks @ee-prog for #4143) -
Help through forwarding aliases: an alias that references
{{ args }}receives--helpand-has arguments, so withsw = "wt switch {{ args }}",wt sw --helpshowswt switchhelp. Such an alias now runs on--help, every pipeline step included, where 0.82.0 ran nothing. Other aliases still point towt config alias show. (#4856, thanks @sdi2200262) -
Last activity and forge API host in list JSON: schema 2 adds
worktree.modified_at, the later of the HEAD commit time and the newest changed or untracked file's mtime. Both schemas report a configuredforge.hostnameasapi_host(repo.forge.api_hostin schema 2,repo.api_hostin schema 1). Docs (#4699, #4857, thanks @zichen0116 and @sdi2200262, and @luiul for #4515 and @owpac for #4762)
Fixed
-
Worktrees checked out inside a removed worktree: when the nested checkout was gitignored in the outer worktree, or
--forcewas passed,wt removeandwt step prunedeleted it with its uncommitted files.wt removenow refuses such a target, and prune skips it. Docs (#4861) -
aqua and mise installs: 0.82.0's signing certificate named a recovery tag instead of
v0.82.0, so aqua and mise'saqua:backend refused to install it. This release is signed under its own version tag. (#4870, thanks @robfeldmann for #4829) -
Picker: the preview keeps its half-width split after a terminal resize, faint text on the selected row has more contrast, and exiting right after
alt-xwaits for the removal instead of abandoning it. (#4867, #4796, #4861, thanks @disrupted for #4793 and the request in #1264) -
Hook templates that can't render: an unguarded
{{ branch }}in a detached worktree (as in jj-colocated repos), or a misspelled variable in apost-commit,post-mergeorpost-removehook, now fails before either source's hook starts, and the command exits 1, as for a syntax error. These failed only in the background hook's log. Docs (#4787) -
Agent plugins: when
worktree-pathruns through a symlinked directory inside the repo, Claude Code'sWorktreeCreatehook prints the resolved path, which Claude Code 2.1.325 requires. OpenCode 2.3 sessions set activity markers once the plugin is reinstalled withwt config plugins opencode install. Thewt-switch-createskill no longer reads as reserving commits for the user's permission. (#4814, #4850, #4828, thanks @ava-terra for #4849) -
Shell integration: PowerShell integration loaded from worktrunk's own binary skips Windows Terminal's
wt.exe(the profile linewt config shell installwrites still runs the firstwtonPATH); once reinstalled withwt config shell install nu, the Nushell wrapper works with a useropenalias; bash, zsh and fish no longer claim a--sourcemeant for another command. (#4786, #4865, #4833) -
Nix home-manager module:
homeModules.defaultdefers to home-manager's ownprograms.worktrunk(26.11 and later) instead of failing with "already declared", and the flake package installs the agent skills home-manager links. (#4788) -
wt mergefrom a linked default-branch worktree: with the primary worktree on another branch,wt merge <target>run from the default branch's linked worktree merged, then skipped post-merge hooks and exited 1 with "Cannot remove the default branch". It now preserves that worktree and succeeds. (#4853) -
Gitea and Forgejo: on Forgejo 16+, CI status finds a same-repo branch's PR beyond the first 20 open PRs.
wt switch pr:Nchecks out PR source branches namedpull/.... (#4864, #4832) -
wt listwith a missing HEAD object: one worktree whose HEAD commit object was absent blanked Commit, Age and Message on every row. Now only that row loses them, with a warning, and schema 2 JSON reports itshead.short_shaasnullrather than"". (#4852) -
Fixes for unusual setups:
varskeys must be lowercase and start with a letter, as git stores them; detached worktrees keep separate summaries; the leftover-branch hint keeps--pathand--execute; unchanged switch history skips rewriting.git/config; a failedwt step promotenames where it staged ignored files;wt listmarks no row primary in a bare repo without a default-branch worktree. (#4830, #4840, #4841, #4866, #4861, #4785)
Documentation
- FAQ inventories: "What files does Worktrunk create?" lists
wt step squash --dry-run's temporary index and sayswt removedeletes the branch only when merged; "What commands does Worktrunk execute?" lists forge CLIs for PR and MR lookups. (#4831, #4847)
Internal
-
MSRV is Rust 1.99. (#4811)
-
minijinja 3.1: templates render with minijinja 3.1, which treats undefined and none values differently in some filters, such as
join,first,lastandlength. (#4809) -
License files:
LICENSEis split intoLICENSE-MITandLICENSE-APACHE, so GitHub detects the dual license; the texts are unchanged. (#4783) -
Source-build versions:
wt --versionon a build from a git checkout describes only version tags (v[0-9]*), so another tag no longer names the version. (#4791) -
Breaking Rust library changes:
GitRepoInfogains a publicapi_hostfield (#4857),GitErroraWorktreeContainsWorktreevariant (#4861), andWorkingTree::status_porcelain_cachedreturnsgit status --porcelain -zbytes instead of aString(#4699).
Install worktrunk 0.83.0
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/max-sixty/worktrunk/releases/download/v0.83.0/worktrunk-installer.sh | sh && wt config shell installInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/max-sixty/worktrunk/releases/download/v0.83.0/worktrunk-installer.ps1 | iex"; git-wt config shell installInstall prebuilt binaries via Homebrew
brew install worktrunk && wt config shell installDownload worktrunk 0.83.0
| File | Platform | Checksum |
|---|---|---|
| worktrunk-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| worktrunk-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| worktrunk-x86_64-pc-windows-msvc.zip | x64 Windows | checksum |
| worktrunk-aarch64-unknown-linux-musl.tar.xz | ARM64 MUSL Linux | checksum |
| worktrunk-x86_64-unknown-linux-musl.tar.xz | x64 MUSL Linux | checksum |
Install via Cargo
cargo install worktrunk && wt config shell installInstall via Winget (Windows)
winget install max-sixty.worktrunk && git-wt config shell installInstall via AUR (Arch Linux)
paru worktrunk-bin && wt config shell install