laravel-herd-worktree

Laravel Herd Worktree is a Claude Code skill that streamlines the process of setting up isolated development environments for Laravel projects. It automates git worktree creation, configures Laravel Herd to serve the worktree at a local domain, and handles environment setup including dependency installation and Vite configuration. The skill prevents naming conflicts by combining project name with branch name, and automatically updates .env files with correct URLs, session domains, and Sanctum settings. Developers working on multiple feature branches simultaneously benefit from this isolation approach, reducing context switching and environment conflicts.

[{"step":"Identify your project and feature branch. Replace [PROJECT_DIRECTORY_PATH] with your Laravel project’s root directory (e.g., `/path/to/my-laravel-app`) and [FEATURE_BRANCH_NAME] with your branch (e.g., `feature/user-auth`).","action":"Use the prompt template to generate the exact commands for creating the worktree."},{"step":"Run the generated commands in your terminal. Ensure you have Laravel Herd installed and running.","action":"Execute the commands step-by-step. Verify the worktree is created in the specified directory."},{"step":"Open Laravel Herd and confirm the worktree is listed as a separate project.","action":"Check the Herd menu bar to see the new project. Adjust PHP version or services if needed."},{"step":"Start developing in the worktree. Use `git worktree list` to manage active worktrees.","action":"Switch between worktrees using `cd` or Herd’s project switcher. Commit changes to the feature branch as usual."},{"step":"Clean up when done. Use `git worktree remove [path]` to delete the worktree when the feature is merged.","action":"Run `git worktree prune` to clean up any stale worktree references."}]