# Create Worktree

> Creates a git worktree with branch and copies environment files (.envrc, .mcp.json)

- Skill: `majiayu000/create-worktree-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/create-worktree-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/create-worktree-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/create-worktree-2

---


# Create Worktree Skill

**CLAUDE: When this skill is invoked with `/create-worktree <branch-name>`, immediately run:**
```bash
./.claude/skills/create-worktree.sh <branch-name>
```

## Purpose
Creates a new git worktree with a feature branch, automatically copying environment files that are not tracked in git.

## Usage
```bash
/create-worktree feature/my-new-feature
```

## What It Does
1. Creates a new git worktree at `../pierre_mcp_server-<branch-name>`
2. Creates a new branch with the specified name
3. Copies `.envrc` from main worktree
4. Copies `.mcp.json` if present
5. Runs `direnv allow` to activate the environment

## Commands

### Using the script directly:
```bash
./.claude/skills/create-worktree.sh <branch-name> [optional-path]

# Examples:
./.claude/skills/create-worktree.sh feature/new-api
./.claude/skills/create-worktree.sh fix/bug-123 /tmp/quick-fix
```

### Manual steps (if script unavailable):
```bash
BRANCH="feature/my-feature"
WORKTREE="../pierre_mcp_server-${BRANCH//\//-}"

git worktree add -b "$BRANCH" "$WORKTREE"
cp .envrc "$WORKTREE/"
cp .mcp.json "$WORKTREE/" 2>/dev/null || true
cd "$WORKTREE" && direnv allow
```

## Cleanup
When done with a worktree:
```bash
git worktree remove ../pierre_mcp_server-feature-my-feature
git branch -d feature/my-feature  # if merged
```

## Related Skills
- `finish-worktree` - Completes feature branch work with rebase and merge