## Prerequisites

- [Ghostty](https://ghostty.org/) terminal emulator
- Git 2.15+ (worktree support)
- macOS

## Installation

Download the latest `.dmg` from the [releases page](https://github.com/sidequery/ghostree/releases) or install via Homebrew:

```bash
brew install --cask sidequery/tap/ghostree
```

## Quick Start

1. Open Ghostree
2. Select a repository from the sidebar
3. Create a new worktree by clicking the **+** button
4. Ghostree opens a Ghostty terminal window in the new worktree directory

Each worktree gets its own Ghostty window, so you can visually distinguish which branch you're working on.

## Managing Worktrees

The sidebar shows all your worktrees for each repository. From there you can:

- **Create** new worktrees from any branch or commit
- **Open** a Ghostty terminal in any worktree
- **Delete** worktrees you no longer need
- **Track agent status** for coding agents like Claude Code running in your worktrees