Skip to content

Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows

Release v0.24.1

Maximilian Roosd76f8204ac8f
diff --git a/.claude/skills/release/SKILL.md b/.claude/skills/release/SKILL.md
index f22c35d11..c7e0817e9 100644
--- a/.claude/skills/release/SKILL.md
+++ b/.claude/skills/release/SKILL.md
@@ -10,7 +10,7 @@ description: Worktrunk release workflow. Use when user asks to "do a release", "
1. **Run tests**: `cargo run -- hook pre-merge --yes`
2. **Check current version**: Read `version` in `Cargo.toml`
3. **Review commits**: Check commits since last release to understand scope of changes
-4. **Credit contributors**: Check for external contributors with `git log v<last-version>..HEAD --format="%an <%ae>" | sort -u` and credit them in changelog entries (see below)
+4. **Credit contributors**: Check for external PR authors and issue reporters (see "Credit External Contributors" and "Credit Issue Reporters" below)
5. **Confirm release type with user**: Present changes summary and ask user to confirm patch/minor/major (see below)
6. **Update CHANGELOG**: Add `## X.Y.Z` section at top with changes (see MANDATORY verification below)
7. **Bump version**: Update `version` in `Cargo.toml`, run `cargo check` to update `Cargo.lock`
@@ -93,27 +93,32 @@ For fixes that reference issues:
- **Bug fix**: Description. Fixes [#123](https://github.com/user/repo/issues/123). (thanks @reporter)
```
-**Finding reporters:**
+**Finding reporters — do ALL three steps:**
-1. **Check for explicit references:** Look for "Fixes #N", "Closes #N", or issue links in PR bodies and commit messages.
+Issues may have been filed months before the fix. Bug reports also appear as PR comments, not just issues. These steps are complementary; each catches things the others miss.
-2. **Review issues since last release:** List all issues opened or closed since the last release tag:
+1. **Extract every issue/PR reference from every commit** (PRIMARY):
```bash
- # Get last release date
- git log -1 --format=%cs v<last-version>
- # List issues closed since then (bugs that got fixed)
- gh issue list --state closed --search "closed:>=<date>" --json number,title,author
- # List issues opened since then (new reports that might have been addressed)
- gh issue list --state all --search "created:>=<date>" --json number,title,author
+ git log v<last-version>..HEAD --format="%B" | grep -oE '#[0-9]+' | sort -un
```
- Scan these for issues that match changes in this release — even if the PR didn't reference them.
+ For **each** referenced number: run `gh issue view N --json title,author,state`. This catches issues filed months ago — the most commonly missed credits.
-3. **Look up issue authors:** `gh issue view N --json author`.
+2. **Check PR comments for bug reports** (catches reports that never became issues):
+ For feature PRs referenced in commits, check comment threads for users reporting problems:
+ ```bash
+ gh pr view NNN --json comments --jq '.comments[] | "\(.author.login): \(.body[:150])"'
+ ```
-PRs often fix issues without explicit "Fixes #N" — especially when the fix approach differs from the issue's suggested solution, or when the fixer discovered the issue independently.
+3. **Survey every issue opened or closed since last release** (catches unreferenced matches):
+ ```bash
+ git log -1 --format=%cs v<last-version>
+ gh issue list --state all --search "created:>=<date>" --json number,title,author --limit 100
+ gh issue list --state closed --search "closed:>=<date>" --json number,title,author --limit 100
+ ```
+ Cross-reference every title against changes in this release.
**When to credit:**
-- Bug reports with clear reproduction steps
+- Bug reports with clear reproduction steps (in issues OR PR comments)
- Feature requests that shaped the implementation
- Performance reports with measurements (like "takes 15s")
- Users who helped diagnose issues through discussion
@@ -158,7 +163,9 @@ For EACH entry:
3. Confirm the entry accurately describes the user-facing change
4. Flag if the entry overstates, understates, or misdescribes the change
-Also check: Are there any user-facing changes in the commits that are NOT covered by these entries?
+Also check:
+- Are there user-facing changes NOT covered by these entries?
+- Verify each "thanks @..." attribution (right person, right role — author vs reporter)
Report format:
- Entry: [entry text]
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 953295f1c..125a33812 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,37 @@
# Changelog
+## 0.24.1
+
+### Improved
+
+- **Template error messages**: Template expansion errors now show what failed, the failing template line, and available variables for undefined variable errors. ([#1041](https://github.com/max-sixty/worktrunk/pull/1041))
+
+- **Interactive picker preview speed**: Preview pre-computation is parallelized via rayon, reducing the chance of a blocking cache miss when switching preview tabs. ([#1048](https://github.com/max-sixty/worktrunk/pull/1048))
+
+- **`wt switch` performance**: Switching to existing worktrees defers path computation, reducing startup latency. ([#1029](https://github.com/max-sixty/worktrunk/pull/1029), [#1030](https://github.com/max-sixty/worktrunk/pull/1030), [#1031](https://github.com/max-sixty/worktrunk/pull/1031))
+
+### Fixed
+
+- **PowerShell wrapper swallows `-D` flag**: The wrapper's `[Parameter(ValueFromRemainingArguments)]` promoted it to an "advanced function", causing PowerShell to consume `-D` as `-Debug` instead of passing it to `wt.exe`. Fixes [#885](https://github.com/max-sixty/worktrunk/issues/885). ([#1057](https://github.com/max-sixty/worktrunk/pull/1057), thanks @DiTo97 for reporting)
+
+- **Nushell shell integration**: Multiple fixes for nushell — auto-detect for install even without vendor/autoload directory ([#1032](https://github.com/max-sixty/worktrunk/pull/1032)), detection checks multiple config paths ([#1038](https://github.com/max-sixty/worktrunk/pull/1038)), uninstall cleans all candidate locations ([#1050](https://github.com/max-sixty/worktrunk/pull/1050)), wrapper hardening and improved diagnostics ([#1059](https://github.com/max-sixty/worktrunk/pull/1059)). (thanks @arnaudlimbourg for [#1032](https://github.com/max-sixty/worktrunk/pull/1032), [#1038](https://github.com/max-sixty/worktrunk/pull/1038), and @omerxx for reporting in [#964](https://github.com/max-sixty/worktrunk/pull/964))
+
+- **Interactive picker leaves screen artifacts**: The picker left visual artifacts after exiting. Fixes [#1027](https://github.com/max-sixty/worktrunk/issues/1027). ([#1028](https://github.com/max-sixty/worktrunk/pull/1028), [#1044](https://github.com/max-sixty/worktrunk/pull/1044), thanks @davidbeesley)
+
+- **Statusline counts files outside sparse checkout cone**: Branch diff statistics in the statusline included files outside the sparse checkout cone, inflating counts. ([#1024](https://github.com/max-sixty/worktrunk/pull/1024), thanks @bendrucker)
+
+- **Template placeholders leak into displayed commands**: `{{ }}` delimiters in hook commands were incorrectly syntax-highlighted, showing ANSI artifacts instead of the template text. ([#1022](https://github.com/max-sixty/worktrunk/pull/1022))
+
+- **Hook announcement trailing colon**: Hook announcements like "Running post-merge project:sync:" had a trailing colon that created visual noise. ([#1025](https://github.com/max-sixty/worktrunk/pull/1025))
+
+- **Blank line after approval prompts**: Approval prompts showed an extra blank line after the user pressed Enter. ([#1040](https://github.com/max-sixty/worktrunk/pull/1040))
+
+### Internal
+
+- **Automated Claude PR review**: Added workflow for automated code review on PRs. ([#1037](https://github.com/max-sixty/worktrunk/pull/1037))
+
+- **Time-to-first-output benchmarks**: Added benchmarks for `remove`, `switch`, and `list` startup latency. ([#1023](https://github.com/max-sixty/worktrunk/pull/1023))
+
## 0.24.0
### Improved
diff --git a/Cargo.lock b/Cargo.lock
index 0a19da3f5..ed7495b70 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -3173,7 +3173,7 @@ checksum = "d7249219f66ced02969388cf2bb044a09756a083d0fab1e566056b04d9fbcaa5"
[[package]]
name = "worktrunk"
-version = "0.24.0"
+version = "0.24.1"
dependencies = [
"ansi-str",
"ansi-to-html",
diff --git a/Cargo.toml b/Cargo.toml
index 37e93c4b1..e1e6fcadc 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -5,7 +5,7 @@ default-members = [".", "tests/helpers/mock-stub"]
[package]
name = "worktrunk"
-version = "0.24.0"
+version = "0.24.1"
edition = "2024"
rust-version = "1.89"
build = "build.rs"