setup-worktree
在当前项目中安装worktree管理脚本
📖 中文导读:在当前项目中安装worktree管理脚本 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
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
# 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:
# 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:
- Running
/setup-worktreein each project - Installing
tsxas a dev dependency - Copying a script file to
scripts/ - Adding a package.json script entry
The new approach:
- Just works with
npx @builtby.win/worktree - No project-specific setup
- Works across all your projects
- 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