gmickel

worktree-kit

Manage git worktrees (create/list/switch/cleanup) and copy .env files. Use for parallel feature work, isolated review, clean workspace, or when user mentions worktrees.

gmickel 687 54 Updated 8mo ago

Resources

1
GitHub

Install

npx skillscat add gmickel/gmickel-claude-marketplace/worktree-kit

Install via the SkillsCat registry.

About this skill

This skill provides a script to manage git worktrees, allowing creation, listing, switching, cleanup, and .env file copying across isolated working directories. It solves the problem of maintaining parallel feature branches and clean workspaces without affecting the main working tree. Use it when performing parallel development, isolated code review, or when git worktree operations are needed.

SKILL.md

Worktree kit

Use the manager script for all worktree actions.

bash ${CLAUDE_PLUGIN_ROOT}/skills/worktree-kit/scripts/worktree.sh <command> [args]

Commands:

  • create <name> [base]
  • list
  • switch <name> (prints path)
  • cleanup
  • copy-env <name>

Safety notes:

  • create does not change the current branch
  • cleanup does not force-remove worktrees and does not delete branches
  • cleanup deletes the worktree directory (including ignored files); removal fails if the worktree is not clean
  • .env* is copied with no overwrite (symlinks skipped)
  • refuses to operate if .worktrees/ or any worktree path component is a symlink
  • copy-env only targets registered worktrees
  • origin fetch is optional; local base refs are allowed
  • fetch from origin only when base looks like a branch
  • Worktrees live under .worktrees/