v3.3.0

🚀 What's New in v3.3.0

This release introduces flexible worktree directory configuration through preferences and the ability to delete multiple worktrees at once.

✨ New Features

Configurable Worktree Directory via Preferences (#318)

You can now configure where phantom stores worktrees using phantom preferences:

# Set custom worktrees directory (relative path)
phantom preferences set worktreesDirectory ../phantom-worktrees

# View current preference
phantom preferences get worktreesDirectory

The preference supports both absolute and relative paths. Relative paths are resolved from your repository root. The default remains .git/phantom/worktrees/.

Note: phantom.config.json worktreesDirectory is now deprecated and will show a warning. Please migrate to preferences.

Delete Multiple Worktrees at Once (#316)

phantom delete now accepts multiple worktree names:

# Delete multiple worktrees
phantom delete feature-a feature-b hotfix-123

# Interactive selection with fzf
phantom delete

🐛 Bug Fixes

• Normalize preference key casing (#319)

🛠️ Improvements

• Add latest Node to CI matrix (#320) - Ensures compatibility with newest Node.js versions

📚 Documentation

• Update Homebrew installation instructions (#313)
• Add platform support notes (#303)

📦 Dependencies

• bump @modelcontextprotocol/sdk from 1.23.0 to 1.24.0 (#314)
• bump @modelcontextprotocol/inspector from 0.17.2 to 0.17.5 (#309)
• bump @biomejs/biome from 2.3.1 to 2.3.8 (#307)
• bump @types/node from 24.9.1 to 24.10.1 (#308)
• bump esbuild from 0.27.0 to 0.27.1 (#312)
• bump actions/checkout from 6.0.0 to 6.0.1 (#305)
• bump actions/setup-node from 6.0.0 to 6.1.0 (#306)
• bump @typescript/native-preview from 7.0.0-dev.20251120.1 to 7.0.0-dev.20251203.1 (#310)

---

Installation/Upgrade:

npm install -g @aku11i/phantom@latest
# or
brew upgrade phantom

Full Changelog: v3.2.0...v3.3.0