Getting Started

Install ghostree and start managing your git worktrees with Ghostty.

Prerequisites

  • Ghostty terminal emulator
  • Git 2.15+ (worktree support)
  • macOS

Installation

Download the latest .dmg from the releases page or install via Homebrew:

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