Skip to content

v0.1.0

Choose a tag to compare

@melonamin melonamin released this 29 Aug 14:48
· 24 commits to main since this release
v0.1.0
77be1c8

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! ๐ŸŒณ