Skip to content

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

Release v0.3.1

Maximilian Roos7ea31021f495
diff --git a/.claude/skills/release/SKILL.md b/.claude/skills/release/SKILL.md
index 2fca329bc..8682d0276 100644
--- a/.claude/skills/release/SKILL.md
+++ b/.claude/skills/release/SKILL.md
@@ -10,14 +10,15 @@ description: Worktrunk release workflow. Use when user asks to "do a release", "
1. **Run tests**: `cargo run -- hook pre-merge --force`
2. **Check current version**: Read `version` in `Cargo.toml`
3. **Review commits**: Check commits since last release to understand scope of changes
-4. **Confirm release type with user**: Present changes summary and ask user to confirm patch/minor/major (see below)
-5. **Update CHANGELOG**: Add `## X.Y.Z` section at top with changes (see MANDATORY verification below)
-6. **Bump version**: Update `version` in `Cargo.toml`, run `cargo check` to update `Cargo.lock`
-7. **Commit**: `git add -A && git commit -m "Release vX.Y.Z"`
-8. **Merge to main**: `wt merge --no-remove` (rebases onto main, pushes, keeps worktree)
-9. **Tag and push**: `git tag vX.Y.Z && git push origin vX.Y.Z`
-10. **Wait for release workflow**: `gh run watch <run-id> --exit-status`
-11. **Update Homebrew**: `./dev/update-homebrew.sh` (requires sibling `homebrew-worktrunk` checkout)
+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)
+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`
+8. **Commit**: `git add -A && git commit -m "Release vX.Y.Z"`
+9. **Merge to main**: `wt merge --no-remove` (rebases onto main, pushes, keeps worktree)
+10. **Tag and push**: `git tag vX.Y.Z && git push origin vX.Y.Z`
+11. **Wait for release workflow**: `gh run watch <run-id> --exit-status`
+12. **Update Homebrew**: `./dev/update-homebrew.sh` (requires sibling `homebrew-worktrunk` checkout)
The tag push triggers the release workflow which builds binaries and publishes to crates.io. The Homebrew script fetches SHA256 hashes from the release assets and updates the formula.
@@ -49,6 +50,21 @@ Notable changes to document:
Skip: internal refactors, doc-only changes, test additions (unless user-facing like shell completion tests).
+### Credit External Contributors
+
+For any changelog entry where an external contributor (not the repo owner) authored the commit, add credit with their GitHub username:
+
+```markdown
+- **Feature name**: Description. ([#123](https://github.com/user/repo/pull/123), thanks @contributor)
+```
+
+Find external contributors:
+```bash
+git log v<last-version>..HEAD --format="%an <%ae>" | sort -u
+```
+
+Then for each external contributor's commit, find their GitHub username from the commit (usually in the email or PR).
+
### MANDATORY: Verify Each Changelog Entry
**After drafting changelog entries, you MUST spawn a subagent to verify each bullet point is accurate.** This is non-negotiable — changelog mistakes are a recurring problem.
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 496eac0a8..001f21b2a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,26 @@
# Changelog
+## 0.3.1
+
+### Fixed
+
+- **Branch names with slashes**: Branch names like `fix/feature-name` no longer break git config markers. Slashes are now escaped for git config compatibility. ([#189](https://github.com/max-sixty/worktrunk/pull/189), thanks @kyleacmooney)
+- **stdin inheritance for `--execute`**: Interactive programs (vim, python -i, claude) now work correctly with `--execute` on non-Unix platforms. ([#191](https://github.com/max-sixty/worktrunk/pull/191))
+- **Filenames with spaces/newlines**: Git status parsing now handles filenames containing spaces and newlines correctly using NUL-separated output.
+- **Concurrent approval race condition**: Multiple concurrent approval/revocation operations no longer overwrite each other. Approvals now reload from disk before saving.
+- **Dirty worktrees incorrectly marked integrated**: Priority 5 integration check now requires clean working tree state, preventing worktrees with uncommitted changes from being flagged as safe to remove.
+- **Type changes not detected as staged**: Index status check now recognizes file type changes (`T` status) as staged changes.
+- **User hook failure strategy**: Hook failure strategy now correctly applies to user hooks instead of always using fail-fast.
+- **Branch variable in detached HEAD**: `{{ branch }}` now correctly expands to "HEAD" in detached HEAD worktrees instead of "(detached)".
+
+### Improved
+
+- **Self-hosted GitLab support**: CI auth checks now detect the GitLab host from the remote URL, supporting self-hosted GitLab instances instead of always checking gitlab.com.
+- **Platform-specific CI status**: `wt list --full` and `wt config show` now show only the relevant CI tool (GitHub Actions or GitLab CI) based on the repository's remote URL.
+- **LLM error reproduction**: When LLM commands fail, error messages now show the full reproduction command (e.g., `wt step commit --show-prompt | llm`) for easier debugging.
+- **Location format**: Messages now use `@` instead of `at` for location phrases (e.g., "Switched to feature @ /path").
+- **Switch help text**: Clarified that `wt switch` creates worktrees automatically for existing branches, not just for new branches with `--create`.
+
## 0.3.0
### Added
diff --git a/Cargo.lock b/Cargo.lock
index ee2ccdac6..b4bff6f94 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -2946,7 +2946,7 @@ checksum = "f17a85883d4e6d00e8a97c586de764dabcc06133f7f1d55dce5cdc070ad7fe59"
[[package]]
name = "worktrunk"
-version = "0.3.0"
+version = "0.3.1"
dependencies = [
"ansi-str",
"ansi-to-html",
diff --git a/Cargo.toml b/Cargo.toml
index ffb8e991c..55dde844b 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -5,7 +5,7 @@ default-members = [".", "tests/helpers/dev-detach"]
[package]
name = "worktrunk"
-version = "0.3.0"
+version = "0.3.1"
edition = "2024"
rust-version = "1.89"
build = "build.rs"