hypr 0.4.0

hypr 🚀

A better git worktree experience

hypr is a modern, highly customizable CLI tool that supercharges your git worktree workflow. It makes creating, switching, and managing worktrees effortless, with first-class terminal integration and powerful automation hooks.

Why hypr?

Git worktrees are amazing for parallel development, but managing them manually is tedious. hypr solves this:

• ⚡ Instant Context Switching: hypr feature-branch handles everything—fetching, creating the worktree, and opening it.
• 🖥️ Terminal Integrated: Automatically opens your worktree in a new tab or window (supports iTerm2, Tmux, Ghostty, VS Code, and more).
• ✨ Interactive TUI: built-in interactive menu for selecting and managing worktrees.
• 🧹 Smart Cleanup: hypr cleanup intelligently finds and deletes worktrees for merged or closed branches (including GitHub integration).
• 🔗 Lifecycle Hooks: Run scripts automatically on create, switch, or cleanup (e.g., bun install or copying .env files).

📦 Installation

Package Managers (Recommended)

Support for various package managers is available:

• Homebrew (macOS/Linux): brew install stephanvs/tap/hypr
• Winget (Windows): winget install hypr
• Scoop (Windows): scoop install hypr
• AUR (Arch Linux): yay -S hypr-bin

.NET Tool (Alternative)

dotnet tool install --global hypr

On .NET 10 SDK-based installs, supported platforms automatically receive a self-contained tool package. Other platforms fall back to the framework-dependent any package.

⚡ Usage

Create & Switch

Create a new worktree for a feature branch and open it instantly in a new tab:

# Creates a worktree for 'my-feature' and opens it
hypr my-feature

Review a pull request

Open a GitHub PR in a dedicated worktree, including PRs from forks:

hypr pr 123
hypr pr https://github.com/owner/repository/pull/123

Requires an authenticated GitHub CLI (gh). Reopening a PR preserves your local work.

Cleanup

Clean up old worktrees. hypr checks if branches are merged or if their PRs are closed.

hypr cleanup

🛠️ Configuration

hypr is highly configurable via a global or project-local hypr.json file.

Example hypr.json:

{
  "worktree": {
    "directoryPattern": "../{repo_name}-worktrees/{branch}"
  },
  "terminal": {
    "mode": "tab"
  },
  "scripts": {
    "sessionInit": "bun install && cp ../main/.env ."
  }
}

See example_config.json for a comprehensive list of options.

🏗️ Development

Prerequisites:

• .NET 10.0 SDK

Build & Run:

# Setup dependencies
./setup.sh

# Build
dotnet build

# Run tests
dotnet test