Repository navigation
v6.2.0
🚀 What's New in v6.2.0
v6.2.0 adds branch-preserving worktree deletion and improves the reliability of Phantom's packaged CLI and test pipeline.
✨ New Features
Keep branches when deleting worktrees (#433)
You can now delete a worktree without deleting its Git branch. This works from the CLI, from MCP clients, and as a global Phantom preference.
# Delete only the worktree and keep the branch
phantom delete feature-auth --keep-branch
# Make branch preservation your default
phantom preferences set keepBranch true🛠️ Improvements
- Migrate the CLI bundler from esbuild to tsdown (#415) - Keeps the existing ESM output and executable behavior while modernizing the build pipeline.
- Move worktree orchestration into
@phantompane/core(#423) - Centralizes create and attach flows in core and keeps CLI handlers focused on parsing and delegation. - Add end-to-end CLI coverage (#424) - Introduces a dedicated
e2e/workspace with Vitest-based coverage for core Phantom commands. - Add E2E coverage for
phantom.config.jsonpost-create hooks (#425) - VerifiespostCreate.copyFilesandpostCreate.commandsin real repository flows. - Migrate tests to Vitest (#413) - Replaces the previous
node --testsetup with Vitest across the monorepo. - Migrate tests to TypeScript (#414) - Converts repository tests to TypeScript and tightens type safety in the suite.
- Extract a dedicated
@phantompane/tmuxpackage (#429) - Separates tmux responsibilities from general process helpers. - Rename the shared workspace package to
utils(#430) - Clarifies package responsibilities and keeps CLI-specific concerns inside the CLI layer. - Fix devenv git-hooks input wiring (#432) - Restores successful
devenv shell -- trueevaluation.
🐛 Bug Fixes
- Bundle Phantom CLI runtime dependencies with tsdown (#417) - Prevents unresolved workspace imports in packaged npm installs and keeps the published CLI runnable.
📚 Documentation
- Document the keep-branch delete workflow (#434) - Adds usage guidance for
phantom delete --keep-branch, thekeepBranchpreference, and the MCPkeepBranchoption.
📦 Dependencies
- Bump
actions/setup-nodefrom 6.2.0 to 6.3.0 (#421) - Bump
@typescript/native-previewfrom 7.0.0-dev.20260309.1 to 7.0.0-dev.20260313.1 (#422) - Bump
@typescript/native-previewfrom 7.0.0-dev.20260313.1 to 7.0.0-dev.20260320.1 (#426) - Bump
@types/nodefrom 25.3.5 to 25.4.0 (#427) - Bump
tsdownfrom 0.21.3 to 0.21.4 (#428)
Installation/Upgrade:
npm install -g @phantompane/cli@latest
# or
brew upgrade phantomFull Changelog: v6.1.0...v6.2.0