> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/ahmadawais/gwtree/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Git worktree manager for parallel development with multiple AI coding agents

## What is GWTree?

GWTree is a git worktree manager built for the AI-assisted development era. Create and manage git worktrees effortlessly, enabling you to **run multiple AI agents in parallel** — Claude Code, Command Code, Cursor on separate branches simultaneously.

## Why GWTree?

Modern development with AI coding agents requires working on multiple features simultaneously. GWTree eliminates the friction of branch switching, stashing, and context loss by giving each agent its own isolated worktree.

**Key benefits:**

* **Multi-agent parallelism** — Run Claude Code, Command Code, Cursor on separate features simultaneously
* **Instant worktree creation** — `gwt a b c -x` creates 3 isolated environments in seconds
* **Clean merges** — Each agent works on its own branch, merge when ready
* **Zero conflicts** — No stashing, no branch switching, no context loss

## Quick example

```bash theme={null}
# Create 3 worktrees instantly for parallel AI agent development
gwt auth api dashboard -x
```

This creates three isolated worktrees:

* **Claude Code** → `repo-auth/` fixing authentication
* **Command Code** → `repo-api/` building API endpoints
* **Cursor** → `repo-dashboard/` creating UI components

Each agent works on its own branch without conflicts. Merge when ready with `gwt merge`.

## Core features

<CardGroup cols={2}>
  <Card title="Batch creation" icon="layer-group">
    Create multiple worktrees at once: `gwt dashboard api auth`
  </Card>

  <Card title="Status dashboard" icon="chart-line">
    See changes, commits ahead/behind, merge status for all worktrees
  </Card>

  <Card title="Smart cleanup" icon="broom">
    Auto-remove merged worktrees, or clean all with `--all`
  </Card>

  <Card title="Merge helper" icon="code-merge">
    One command to merge, remove worktree, and delete branch
  </Card>

  <Card title="Quick creation" icon="bolt">
    Minimal prompts, smart defaults, transparent command output
  </Card>

  <Card title="Interactive management" icon="list">
    List, search, and delete worktrees with fuzzy search
  </Card>
</CardGroup>

## Get started

<CardGroup cols={2}>
  <Card title="Installation" icon="download" href="/installation">
    Install GWTree globally with your favorite package manager
  </Card>

  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Get your first worktree running in minutes
  </Card>
</CardGroup>

## Smart naming pattern

GWTree follows a consistent naming pattern: `{repo}-{name}` for worktrees with matching branch names.

```bash theme={null}
gwt feature-login
# Creates: repo-feature-login/ with branch feature-login
```

## Interactive UX

Clean, compact output with visual indicators:

```bash theme={null}
│
│  ◆  Create  git worktree add -b "feature-login" .../repo-feature-login "main"
│  └  /path/to/repo-feature-login
│
│  ◆  Install  pnpm install
│  └  installs dependencies
│
└  Done  cd ../repo-feature-login
```