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 711 61 Actualitzat fa 10 mesos

Recursos

1
GitHub

Instal·la

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

Instal·la des del registre de SkillsCat.

Sobre aquest 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/