Repository navigation
v0.1.0
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
$SHELLpreference - 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/gtLinux (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/gtVia 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 notarizedgt-linux-amd64.tar.gz- Linux x86_64 binarygt-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! ๐ณ