super-worktree

super-worktree

Git worktree manager with env file copying and node_modules symlinking. Work on multiple branches at once without leaving your session.

---

What users can say (copy-paste prompts)

After installing, users can say things like these to their AI agent:

Create:

• "Create a worktree for feature/login"
• "Set up a worktree for hotfix from production"
• "Start work on TEST-1 with slug 'test feature'"
• "Spin up a worktree for PR 1234" (requires gh)
• "Spin up a worktree for MR 42" (requires glab)

Manage:

• "List my worktrees / show me which ones are dirty"
• "Delete the payments worktree"
• "Re-sync env files into the login worktree"
• "Merge feature/login back into main and clean up"
• "Prune orphan worktrees"
• "Show me worktree status as JSON"

With AI tool integration:

• "Create a worktree and append claude to the cd hint"
• --tool opencode or --tool codex also work

---

How it works

bash scripts/worktree-manager.sh create <branch> [from-branch] [options]

1. Creates a git worktree at .worktrees/<branch>/
2. Copies env files (.env, credentials, etc.) from source
3. Symlinks node_modules (saves disk space)
4. Runs lifecycle hooks (preCreate, postCreate, etc.)
5. Prints a copy-pasteable cd hint

---

Config schema (super-worktree.json)

Place in repo root. All fields optional.

{
  "$schema": "./schemas/super-worktree.schema.json",
  "version": 1,
  "sync": {
    "copyFiles": [
      ".env", ".env.*", ".envrc", ".local.*",
      "*.secret", "*.key", ".secrets.*",
      "credentials.json", "credentials.yml", "credentials.env",
      "auth.json", "auth.yml", "auth.env",
      ".dev.vars", ".prod.vars", ".staging.vars"
    ],
    "symlinkDirs": ["node_modules"],
    "exclude": ["node_modules", ".git", "dist", "build", ".next",
                "out", "coverage", ".turbo", ".vercel", ".worktrees"],
    "copyDepth": 2
  },
  "hooks": {
    "preCreate":  "echo creating $BRANCH",
    "postCreate": "pnpm install --frozen-lockfile",
    "preDelete":  "echo cleaning $BRANCH"
  }
}