Is the setup-worktree skill still required for every project?

No, the manual setup skill is now deprecated in favor of the @builtby.win/worktree npm package, which provides a global CLI accessible from any project.

Why should I use worktrees instead of normal branching?

Worktrees allow you to have multiple branches checked out in separate directories at once, eliminating the need to stash changes when switching tasks.

How does the tool handle database state between worktrees?

It specifically supports SQLite by taking automatic snapshots, allowing each worktree to maintain its own independent database state for testing.

Can I use this with pnpm or Yarn?

Yes, the tool is package manager agnostic and works correctly with npm, yarn, and pnpm environments.

Will my existing worktree metadata still work?

Yes, the new npm-based CLI is fully backwards compatible with the .worktree-metadata.json files generated by previous versions of the skill.

Worktree Automation Utility

Name: Worktree Automation Utility
Author: builtby-win

bybuiltby-win

0•

Productivity & Workflow

Streamlines Git worktree management by automating feature isolation, database snapshots, and development server setup.

The Worktree Automation skill enhances Claude Code's ability to manage isolated development environments through Git worktrees. It enables developers to work on multiple issues simultaneously without the friction of stashing or frequent context switching. While the legacy setup process is now deprecated in favor of a centralized npm CLI, this utility remains the standard for maintaining clean project structures, providing automatic SQLite database snapshots, intelligent port assignment for dev servers, and seamless integration with npm, yarn, and pnpm.

Key Features

01Intelligent port management to avoid development server conflicts

02Agnostic support for npm, yarn, and pnpm package managers

03Automatic SQLite database snapshots for state preservation

040 GitHub stars

05Automated dev server startup for new worktree environments

06Isolated feature development via dedicated Git worktrees

Use Cases

01Maintaining independent database states for different development tasks

02Running separate project instances for side-by-side debugging and PR review

03Switching between multiple active features without commit/stash overhead

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add builtby-win/skills setup

For use in Claude.ai and ChatGPT

Download Skill