flow-next-worktree-kit

Manage git worktrees and copy .env files across branches via bash script.

674|52|Updated Dec 26, 2025
One-click install
npx skills add https://github.com/gmickel/gmickel-claude-marketplace --skill flow-next-worktree-kit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: flow-next-worktree-kit
Source: https://github.com/gmickel/gmickel-claude-marketplace/tree/main/plugins/flow-next/skills/flow-next-worktree-kit
Command: npx skills add https://github.com/gmickel/gmickel-claude-marketplace --skill flow-next-worktree-kit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, and includes scripts (resource) components.

What problem does it solve?

This Skill simplifies managing multiple Git worktrees and environment provisioning, enabling parallel feature work, isolated reviews, and tidy workspaces.

Core Features & Use Cases

  • Create, list, switch, and cleanup worktrees for feature branches without polluting the main workspace.
  • Environment copy: automatically copy non-sensitive .env files into new worktrees to preserve config context.
  • Use Case: When working on multiple features in parallel, quickly setup isolated worktrees and keep environment separation.

Quick Start

Use the worktree script to manage worktrees, for example: bash ${DROID_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/flow-next-worktree-kit/scripts/worktree.sh create feature-1 main

Frequently Asked Questions about flow-next-worktree-kit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage git worktrees for parallel feature development?

Git worktrees allow you to maintain isolated workspaces for parallel feature development. This Skill automates worktree creation and applies safety checks to keep branches separate without polluting your main workspace.

How do I copy .env files into new git worktrees automatically?

To copy .env files into new git worktrees, the workspace management script automatically propagates non-sensitive environment configurations during worktree creation to preserve config context across isolated branches.

When do I need to use git worktrees instead of cloning repositories?

You need git worktrees when you require isolated workspaces for parallel feature development on different branches. This approach shares a single repository history, avoiding the disk overhead of multiple full clones.

Does this git worktree workflow require any specific dependencies?

Yes, this workspace management workflow requires git as its sole dependency. The orchestration logic runs entirely through a single bash script, ensuring compatibility wherever git is installed.

What safety checks are enforced when creating git worktrees for feature branches?

When creating git worktrees, the script enforces safety checks and path validations, along with optional origin and base branch handling, to ensure safe creation and prevent accidental workspace overwrites or conflicts.

What is the best way to clean up git worktrees after a feature review?

The best way to clean up git worktrees after a feature review is to use the script's cleanup command, which safely removes isolated workspaces and ensures your main working directory remains tidy and unpolluted.