worktrees

Manage git worktrees for parallel development across multiple projects.

19|3|Updated Dec 15, 2025
One-click install
npx skills add https://github.com/GobbyAI/gobby --skill worktrees-gobbyai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worktrees
Source: https://github.com/GobbyAI/gobby/tree/main/src/gobby/install/shared/skills/worktrees
Command: npx skills add https://github.com/GobbyAI/gobby --skill worktrees-gobbyai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill simplifies and automates the management of git worktrees, enabling parallel development by creating, listing, spawning agents into, syncing, and cleaning up worktrees within a Gobby-enabled workflow.

Core Features & Use Cases

  • Create and manage isolated worktrees for feature development without disturbing main branches.
  • Spawn agents into specific worktrees to run tasks in isolated environments.
  • Sync worktrees with base branches and clean up stale worktrees to maintain repository hygiene.
  • Use Case: When multiple features are developed in parallel, rapidly create separate worktrees, spawn agents to work on tasks, and clean up when done.

Quick Start

Use /gobby worktrees create <branch> to create a new worktree, or use /gobby worktrees list to view existing worktrees, or /gobby worktrees spawn <branch> "<task description>" to spawn an agent in a new worktree.

Frequently Asked Questions about worktrees

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

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

Git worktrees provide isolated directory environments linked to a single repository, enabling parallel feature development without disturbing main branches. They are needed when running multiple tasks concurrently across different branches.

How do I create and list isolated git worktrees for feature branches?

You can create and list isolated git worktrees by routing subcommands through a gobby-worktrees MCP server, which parses parameters like branch name, task ID, and worktree path to automate directory setup.

Can I spawn agents into specific git worktrees to run isolated tasks?

Yes, you can spawn agents into specific git worktrees to run isolated tasks by providing a branch name and task description. The agent operates independently within that worktree without affecting other branches.

How do I sync worktrees with the base branch and clean up stale ones?

You can sync worktrees with base branches and clean up stale ones to maintain repository hygiene by executing sync and cleanup subcommands. This ensures parallel development directories remain updated and unnecessary worktrees are removed.

Do I need an MCP server to automate git worktree management?

Yes, automating git worktree management requires a gobby-worktrees MCP server to parse user input, route subcommands, and expose structured parameters like task ID and worktree path for creating, syncing, and cleaning up directories.

What is the best way to handle parallel development when working with multiple features?

The best way to handle parallel development with multiple features is to use git worktrees to rapidly create separate working directories, spawn agents to work on isolated tasks, and clean up the worktrees when development is done.