Skip to content

Releases: andr3van/git-turnouts

v1.0.1 - Symlink Configuration Resolution Fix

09 Jan 07:05

Choose a tag to compare

Release title:
v1.0.1 - Symlink Configuration Resolution Fix

Release notes:

🐛 Bug Fixes

Fixed: Configuration file not loading when installed via symlink

This hotfix resolves a critical issue where git-turnouts could not properly load configuration files when installed using the recommended symlink method (ln -s "$(pwd)/git-turnouts" /usr/local/bin/git-turnouts).

What was broken:

  • Configuration files (.config.yml and .config.yml.example) were not found
  • Global settings (like base_dir, copy_files, open_with) were ignored
  • gto config init command failed with "Example file not found" error
  • Worktrees were created in auto-detected locations instead of configured directories

What's fixed:

  • ✅ Script now properly resolves symlinks to find its actual installation directory
  • ✅ Configuration files are correctly loaded from the git-turnouts directory
  • gto config init works properly with symlink installation
  • gto config show displays correct file paths
  • ✅ Global base_dir and other settings are now respected

Impact:
If you installed git-turnouts using the symlink method, your configuration settings will now work as expected. No reinstallation needed - just pull the latest changes or update your symlink.

Technical Details:

  • Fixed symlink resolution in load_configuration() function
  • Fixed symlink resolution in cmd_config() function
  • Updated version to 1.0.1

Installation

For new installations or updates:

cd /path/to/git-turnouts
git pull

The symlink will automatically use the updated script.

Git Turnouts v1.0.0 - Initial Release

06 Jan 09:47

Choose a tag to compare

🎉 Git Turnouts v1.0.0 - Initial Release

Switch between branches like a pro - your Git branch switching yard

We're excited to announce the first stable release of Git Turnouts! A command-line tool for managing Git worktrees with intelligent GitHub Pull Request integration.

✨ Key Features

  • 🔀 Smart PR Integration - Create worktrees directly from PR numbers or titles
  • ⚙️ Centralized Configuration - One YAML file manages all your projects
  • 📂 Automatic File Copying - Copy essential configs (.env, .editorconfig, etc.) to new worktrees
  • 🚀 Automatic Opening - Open worktrees in IntelliJ IDEA, VS Code, iTerm, Warp, or Finder
  • 🛡️ Branch Protection - Prevent accidental deletion of important branches
  • 📊 Bulk Removal - Remove multiple worktrees efficiently
  • 🎯 Project Detection - Automatically detects project names and applies settings

📋 Requirements

  • Unix-like OS (macOS, Linux)
  • Git 2.5 or newer
  • Bash 3.2+
  • jq (for JSON parsing) - Install jq
  • GitHub CLI (gh) (optional, for PR features) - Install gh

🚀 Quick Start

Installation

git clone https://github.com/andr3van/git-turnouts.git
cd git-turnouts
chmod +x git-turnouts
sudo ln -s "$(pwd)/git-turnouts" /usr/local/bin/git-turnouts

Basic Usage

# Create worktree from branch
git-turnouts add feature-auth

# Create worktree from PR number
git-turnouts add 7113

# Create worktree from PR title search
git-turnouts add "Add user authentication"

# Remove worktrees
git-turnouts remove feature-auth

# List all worktrees
git-turnouts list

🎯 What's Included

- ✅ Complete worktree management (add, remove, list)
- ✅ GitHub PR integration with smart search
- ✅ Flexible configuration system (global + project-specific)
- ✅ Automatic file copying for consistent environments
- ✅ IDE/application launcher integration
- ✅ Branch protection rules
- ✅ Comprehensive test suite (54+ tests)
- ✅ Detailed documentation and troubleshooting guide
- ✅ MIT License

🌍 Platform Support

Currently Supported:
- macOS (fully supported)
- Linux (core features fully supported, automatic opening in development)

Future Plans:
- Windows native support (coming soon)

📚 Documentation

- README: Complete usage guide and examples
- CONTRIBUTING: Guidelines for contributors
- Troubleshooting: Common issues and solutions

🐛 Known Limitations

- Automatic opening (--open flag) uses macOS-specific commands
  - On Linux: worktrees are created successfully but auto-opening is not yet supported
- Windows native support is planned but not yet available

🤝 Contributing

Contributions are welcome! Whether you're fixing bugs, adding features, or improving documentation.

See https://github.com/andr3van/git-turnouts/blob/main/CONTRIBUTING.md for guidelines.

Areas where help is appreciated:
- 🎨 New IDE/application adapters
- 🐛 Bug reports and fixes
- 📚 Documentation and tutorials
- ✨ New features
- 🌍 Platform support (Windows, additional Unix-like systems)

📄 License

MIT License - see https://github.com/andr3van/git-turnouts/blob/main/LICENSE file for details

---
Full Changelog: Initial release

Thank you for using Git Turnouts! 🚀