Skip to content

v6.2.0

Choose a tag to compare

@aku11i aku11i released this 29 Mar 14:22
· 404 commits to main since this release
8749ec2

🚀 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.json post-create hooks (#425) - Verifies postCreate.copyFiles and postCreate.commands in real repository flows.
  • Migrate tests to Vitest (#413) - Replaces the previous node --test setup 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/tmux package (#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 -- true evaluation.

🐛 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, the keepBranch preference, and the MCP keepBranch option.

📦 Dependencies

  • Bump actions/setup-node from 6.2.0 to 6.3.0 (#421)
  • Bump @typescript/native-preview from 7.0.0-dev.20260309.1 to 7.0.0-dev.20260313.1 (#422)
  • Bump @typescript/native-preview from 7.0.0-dev.20260313.1 to 7.0.0-dev.20260320.1 (#426)
  • Bump @types/node from 25.3.5 to 25.4.0 (#427)
  • Bump tsdown from 0.21.3 to 0.21.4 (#428)

Installation/Upgrade:

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

Full Changelog: v6.1.0...v6.2.0