worktree-testing

Guide testing local changes within isolated Claude Code worktrees.

Updated Mar 17, 2023
One-click install
npx skills add https://github.com/IainMcl/dotfiles --skill worktree-testing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worktree-testing
Source: https://github.com/IainMcl/dotfiles/tree/main/claude/skills/worktree-testing
Command: npx skills add https://github.com/IainMcl/dotfiles --skill worktree-testing

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides guidance on how to effectively test changes locally when working within a Claude Code worktree, ensuring a smooth development and verification process.

Core Features & Use Cases

  • Worktree Isolation: Understand how worktrees create isolated copies of the repository for independent development.
  • Dependency Management: Learn how to install necessary dependencies within a new worktree environment.
  • Running Dev Servers: Execute development servers and other commands within the worktree as you would in the main repository.
  • Port Conflict Resolution: Be aware of and manage potential port conflicts with existing development instances.
  • Cross-Terminal Testing: Utilize separate terminals to run servers or interact with the worktree environment while Claude operates in its session.
  • Automatic Cleanup: Understand the automatic deletion of worktrees when no changes are made, and the prompt for manual cleanup when changes are present.

Quick Start

Navigate to your worktree directory and run 'just run' to start the development server.

Frequently Asked Questions about worktree-testing

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

FAQPage Schema
How do I test local changes within a Claude Code worktree?

To test local changes in a Claude Code worktree, navigate to the worktree directory, install dependencies, and run the dev server using 'just run' to verify your isolated repository copy.

What are Claude Code worktrees used for in local testing?

Claude Code worktrees create isolated copies of your repository for independent development, allowing you to safely test local changes without affecting the main branch environment.

How do I resolve port conflicts when running a dev server in a worktree?

To resolve port conflicts when running a dev server in a worktree, you must be aware of existing development instances and manage the active ports to prevent server collisions during local testing.

Can I test worktree changes from a separate terminal while Claude operates?

Yes, you can utilize separate terminals to run dev servers or interact with the worktree environment for cross-terminal testing while Claude operates simultaneously in its own session.

When are Claude Code worktrees automatically deleted?

Claude Code worktrees are automatically deleted when no changes are made, but you will be prompted for manual cleanup when changes are present in the isolated worktree environment.