Isolated Worktree Workspaces FAQs

Question 1

Do I need to manually configure the repos in my project?

Accepted Answer

No, the skill includes an auto-detection feature that scans for git subdirectories and identifies build/start commands from files like package.json or pyproject.toml to generate a configuration for you.

Question 2

How does the skill handle environment variables between services?

Accepted Answer

It automatically copies your .env files and applies patches that update URLs and ports, ensuring that your frontend in the worktree correctly points to the backend running within that same isolated worktree.

Question 3

Does this skill work with database migrations?

Accepted Answer

The skill includes safety rules that advise the AI agent against running migrations, as worktrees typically share the same local database. It alerts the user if schema changes are required to prevent data corruption.

Question 4

What is the advantage of using 'portless' mode?

Accepted Answer

When portless is installed, the skill generates stable, human-readable URLs (e.g., http://backend-feature.localhost:1355) instead of incrementing port numbers, making service discovery much more reliable.

Question 5

What is a git worktree and how does this skill use them?

Accepted Answer

A git worktree allows you to have multiple branches of the same repository checked out in different directories at once. This skill automates that process for monorepos, setting up a completely separate workspace directory for each feature branch.

Isolated Worktree Workspaces

主な機能

ユースケース

Isolated Worktree Workspaces

主な機能

ユースケース