---

name: setup-worktree description: "[DEPRECATED] Worktree CLI is now available via npm - no setup needed"

Setup Worktree (Deprecated)

This skill is deprecated. The worktree CLI is now available as an npm package. No project-specific setup is required anymore!

Use the npm CLI Instead

Copy# Use directly with npx (no install needed)
npx @builtby.win/worktree create 15 dark-mode --start-server
npx @builtby.win/worktree list
npx @builtby.win/worktree delete 15

# Or install globally for faster access
npm install -g @builtby.win/worktree
worktree create 15 dark-mode --start-server

Migration

If you previously ran /setup-worktree in a project, you can optionally clean up:

Copy# Remove local script (optional)
rm scripts/manage-worktree.ts

# The npx CLI is fully compatible with existing .worktree-metadata.json files

Why the Change?

The old approach required:

1. Running /setup-worktree in each project
2. Installing tsx as a dev dependency
3. Copying a script file to scripts/
4. Adding a package.json script entry

The new approach:

1. Just works with npx @builtby.win/worktree
2. No project-specific setup
3. Works across all your projects
4. Stays up-to-date automatically

Features (Unchanged)

• Isolated Development: Create separate worktrees for each issue/feature
• Database Snapshots: Automatically snapshot SQLite databases
• Port Management: Auto-assign ports to avoid conflicts
• Dev Server Control: Optionally start dev servers automatically
• Package Manager Agnostic: Works with npm, yarn, or pnpm

See Also

• Worktree Plugin README
• npm package: @builtby.win/worktree