Release Notes
Improved
- Diagnostic report generation:
wt list --verbosegenerates diagnostic reports (.git/wt-logs/diagnostic.md) when warnings or errors occur, with agh issue createcommand hint when GitHub CLI is available. - Alias bypass detection:
wt config showdetects shell aliases that point to binary paths (e.g.,alias gwt="/usr/bin/wt") and warns that they bypass shell integration with suggested fixes. - Switch message clarity: Messages now explicitly state what was created — "Created branch X and worktree" vs "Created worktree for X" vs "Switched to worktree for X".
- Worktree-path hint: One-time hint after first
wt switch --createsuggestingwt config createto customize worktree locations. - Path mismatch warnings:
wt removeandwt mergeshow warnings when worktree paths don't match the config template. - CLI command ordering: Commands reordered by usage frequency in
--help(switch, list, remove, merge...).
Fixed
- Progress counter overflow: Fixed
wt listprogressive rendering when URL sends caused completed count to exceed expected count. - Windows shell integration: Shell function now correctly strips
.exesuffix, relying on MSYS2/Git Bash automatic resolution (fixes #348). - Prunable worktrees: Gracefully handle worktrees where the directory was deleted but git still tracks metadata.
- Help text tables: Disabled clap text wrapping to preserve markdown tables in
--helpoutput.
Documentation
- FAQ entries: Added entries for "What files does Worktrunk create?" and "What can Worktrunk delete?".
Internal
- Hint state management: New
wt config state hintssubcommand for viewing and clearing shown hints. - Deprecated config deduplication: Migration files (
.new) only written once per repo, tracked via git config hints.
Install worktrunk 0.9.4
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/max-sixty/worktrunk/releases/download/v0.9.4/worktrunk-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/max-sixty/worktrunk/releases/download/v0.9.4/worktrunk-installer.ps1 | iex"Download worktrunk 0.9.4
| 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 |