git-worktree-runner

Create, list, remove, and navigate git worktrees with configurable defaults.

1.3k|142|Updated Jun 18, 2025
One-click install
npx skills add https://github.com/dyoshikawa/rulesync --skill git-worktree-runner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-worktree-runner
Source: https://github.com/dyoshikawa/rulesync/tree/main/.rulesync/skills/git-worktree-runner
Command: npx skills add https://github.com/dyoshikawa/rulesync --skill git-worktree-runner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manages git worktrees using git-worktree-runner (gtr). Use when the user needs to create, list, remove, or navigate worktrees with git gtr commands, open editors or AI tools in worktrees, manage parallel development branches, or check out GitHub PRs (including from forks) into worktrees.

Core Features & Use Cases

  • Create, list, remove, and navigate worktrees with git gtr commands
  • Open editors or AI tools in a worktree to speed up development
  • Manage parallel development branches and track PRs from forks
  • Integrate PR checkout flows into isolated worktrees for review and testing

Quick Start

Run git gtr new feature-branch to create a new worktree and immediately open it in your configured editor.

Frequently Asked Questions about git-worktree-runner

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

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

Git worktree management is handled by wrapping git worktree commands with `gtr` to create, list, remove, and navigate isolated directories for parallel branch development without leaving the main repository.

How do I checkout a GitHub pull request from a fork into a git worktree?

Checking out GitHub pull requests from forks into isolated worktrees is supported by the `gtr` command flows, allowing you to review and test PR code in a separate directory before merging.

Can I open my editor or AI tools directly inside a git worktree?

Yes, you can open configured editors and launch AI tools directly within a git worktree using `gtr` commands, speeding up development and code review in isolated branch environments.

What is the best way to create and switch between worktrees for PR review?

Creating and switching worktrees for PR review is streamlined by running `git gtr new feature-branch` to immediately open a new isolated worktree in your configured editor for testing.

Do I need any external dependencies to use git-worktree-runner for branch isolation?

No external dependencies are required to use git-worktree-runner; it operates independently to wrap standard git worktree commands and manage isolated PR workspaces with configurable defaults.