What's Changed

Fixed

• Fix TUI hanging on startup and refresh when fetching worktree details
• Honor XDG_CONFIG_HOME for config lookup before platform defaults

Installation

macOS (Universal - Intel + Apple Silicon)

curl -L https://github.com/melonamin/gt/releases/download/v0.4.1/gt-macos-universal.zip -o gt.zip
unzip gt.zip
chmod +x gt-macos-universal
sudo mv gt-macos-universal /usr/local/bin/gt

Linux (amd64)

curl -L https://github.com/melonamin/gt/releases/download/v0.4.1/gt-linux-amd64.tar.gz | tar xz
chmod +x gt-linux-amd64
sudo mv gt-linux-amd64 /usr/local/bin/gt

Linux (arm64)

curl -L https://github.com/melonamin/gt/releases/download/v0.4.1/gt-linux-arm64.tar.gz | tar xz
chmod +x gt-linux-arm64
sudo mv gt-linux-arm64 /usr/local/bin/gt

From source

go install github.com/melonamin/gt@v0.4.1

Full Changelog: v0.4.0...v0.4.1

Fixed

• Use .git/info/exclude for worktree ignore entries instead of editing .gitignore
• Fail worktree creation when the worktree directory contains tracked files

Downloads

macOS binary is signed and notarized by Apple.

What's New in v0.3.0

Merge & Delete Workflow (#2)

New feature to merge a worktree's branch into the default branch and delete both the worktree and branch in one operation.

TUI

• Press m on any worktree to start the merge flow
• Choose strategy: s for squash, f for fast-forward only
• Confirmation prompt before executing

CLI

gt --merge <branch>              # Fast-forward merge (default)
gt --merge <branch> --squash     # Squash merge
gt --merge <branch> --ff-only    # Explicit ff-only

Configuration

New default_merge_strategy option in ~/.config/gt/config.json:

{
  "default_merge_strategy": "squash"
}

Safety Features

The merge operation is blocked if:

• Worktree has uncommitted changes
• Branch is behind the default branch (for ff-only)
• Branch has no new commits to merge
• Worktree is currently checked out
• Target is the default branch itself

Installation

macOS (Universal Binary)

curl -L https://github.com/melonamin/gt/releases/download/v0.3.0/gt-macos-universal.zip -o gt.zip
unzip gt.zip && chmod +x gt-macos-universal
sudo mv gt-macos-universal /usr/local/bin/gt

Linux (amd64)

curl -L https://github.com/melonamin/gt/releases/download/v0.3.0/gt-linux-amd64.tar.gz | tar xz
chmod +x gt-linux-amd64 && sudo mv gt-linux-amd64 /usr/local/bin/gt

Linux (arm64)

curl -L https://github.com/melonamin/gt/releases/download/v0.3.0/gt-linux-arm64.tar.gz | tar xz
chmod +x gt-linux-arm64 && sudo mv gt-linux-arm64 /usr/local/bin/gt

Via Go

go install github.com/melonamin/gt@v0.3.0

Release Assets

• gt-macos-universal.zip - macOS universal binary (Intel + Apple Silicon)
• gt-linux-amd64.tar.gz - Linux x86_64 binary
• gt-linux-arm64.tar.gz - Linux ARM64 binary
• SHA-256 checksums provided for all assets

What's New

Features

• Worktree creation: Create worktrees with custom branch names and optional custom paths (n key)
• Actions menu: Contextual actions menu (a key) with macOS integrations (Finder, Terminal, IDE)
• Navigation shortcuts: Jump to default branch (^), previous worktree (-), or current worktree (@)
• Inline search: Filter worktrees with / key
• Auto-refresh: Background refresh on window focus and periodic updates

Fixes & Improvements

• Security: Branch name validation now rejects shell metacharacters
• Fixed scroll offset persistence when navigating long lists
• Fixed Unicode truncation in commit messages
• Operational errors now displayed in UI (auto-clear on keypress)
• Status message shown on worktree refresh failure
• Added documentation to input mode constants

Release Notes for v0.1.0

🎉 Introducing gt - Git Worktree Manager

I'm excited to announce the first release of gt, a blazing fast TUI that makes Git worktrees actually pleasant to use.

If you've ever lost work to a messy stash, struggled with branch switching, or ended up with repo-backup, repo-new, repo-actually-working directories everywhere - this tool is for you.

✨ What is gt?

gt makes Git worktrees as easy as breathing. Each branch gets its own working directory. No more stashing, no more conflicts, just instant context switching.

Quick Demo

# Create and switch to a new worktree instantly
gt feature-auth

# Create from a specific branch
gt hotfix main

# Or use the beautiful TUI
gt

🚀 Key Features

Instant Worktree Creation

• gt feature-x - Create and switch in one command
• No configuration needed - works out of the box
• Automatically organizes worktrees in .worktrees/

Beautiful Interactive TUI

• See all worktrees at a glance
• Visual status indicators (dirty/clean/current)
• Real-time commit info and timestamps
• Fuzzy search across branches and commits

Smart Automation

• Auto-adds .worktrees/ to .gitignore
• Respects your $SHELL preference
• Configurable storage location
• Zero dependencies - single binary

📦 Installation

macOS (Universal Binary)

curl -L https://github.com/melonamin/gt/releases/download/v0.1.0/gt-macos-universal.zip -o gt.zip
unzip gt.zip && chmod +x gt-macos-universal
sudo mv gt-macos-universal /usr/local/bin/gt

Linux (amd64)

curl -L https://github.com/melonamin/gt/releases/download/v0.1.0/gt-linux-amd64.tar.gz | tar xz
chmod +x gt-linux-amd64 && sudo mv gt-linux-amd64 /usr/local/bin/gt

Via Go

go install github.com/melonamin/gt@latest

🎯 Why gt?

Git worktrees are powerful but clunky to use. gt makes them feel native:

• No more lost stashes - Each branch has its own directory
• No more context switching overhead - Just switch directories
• No more merge conflicts after stash pop - Nothing to pop
• No more "Cannot switch branch with uncommitted changes" - Switch anytime

🔧 Technical Details

• Written in Go for blazing performance
• Built with Bubble Tea for a delightful TUI
• Signed and notarized on macOS
• Cross-platform: macOS (Intel/Apple Silicon) and Linux (amd64/arm64)
• Single static binary with no runtime dependencies

📝 Release Assets

• gt-macos-universal.zip - macOS universal binary (Intel + Apple Silicon), signed and notarized
• gt-linux-amd64.tar.gz - Linux x86_64 binary
• gt-linux-arm64.tar.gz - Linux ARM64 binary
• SHA-256 checksums provided for all assets

🙏 Acknowledgments

Built with the excellent Bubble Tea TUI framework.

📚 Documentation

Full documentation and examples: GitHub Repository

🐛 Feedback

Found a bug or have a feature request? Please open an issue.

Try it out and let me know what you think! Worktrees have been Git's best-kept secret for too long. Let's change that.

Happy branching! 🌳