A lightweight, cross-platform desktop application that makes creating and managing Git aliases simple and intuitive. Built with Rust + Tauri for native performance and React for a modern UI.
- Visual command builder: Select Git commands with checkboxes instead of writing complex shell scripts
- Real-time preview: See exactly what your alias will do before creating it
- Smart validation: Get warnings about naming conflicts and invalid inputs
- Parameter customization: Configure commit messages, branch names, and other command parameters
- OpenAI integration: Generate meaningful commit messages based on your staged changes
- Multiple AI models: Support for GPT-3.5, GPT-4, and GPT-4o Mini
- Secure API key storage: Your credentials stay on your machine
- View existing aliases: See all your Git aliases in one place
- Smart organization: Distinguish between tool-created and manual aliases
- Easy cleanup: Delete aliases you no longer need
- Conflict detection: Get notified when alias names already exist
Built-in support for the most common Git operations:
- Stage changes (
git add .) - Commit with messages (
git commit -m "message") - Push to remote (
git push) - Switch branches (
git checkout <branch>) - Pull latest changes (
git pull) - Branch cleanup (remove stale local branches)
-
Clone and setup
git clone https://github.com/cridertechnologies/git-alias-generator.git cd git-alias-generator npm install -
Install Tauri CLI (if not already installed)
npm install -g @tauri-apps/cli
# Start development server with hot reload
npm run tauri dev# Create optimized build for your platform
npm run tauri buildRun the development server or install the built application for your platform.
- Name your alias: Enter a unique name like
save,sync, ordeploy - Select commands: Check the Git operations you want to include
- Configure options: Set commit messages, branch names, etc.
- Preview: Click "Preview Command" to see the generated alias
- Create: Click "Create Alias" to save it to your Git configuration
# Use your new alias from any Git repository
git save
git sync
git deploy- Click "Show Settings" to add your OpenAI API key
- Choose your preferred AI model
- Enable AI-generated commit messages for smarter commits
Quick Save & Push
git config --global alias.save "!f() { git add .; git commit -m 'WIP: Quick save'; git push; }; f"Usage: git save
Smart Commit with AI
git config --global alias.smart "!f() { git add .; git commit -m '$(ai-generated-message)'; git push; }; f"Usage: git smart
Branch Cleanup
git config --global alias.cleanup "!f() { git remote update origin --prune; git branch -vv | grep ': gone]' | grep -v '*' | awk '{print $1; }' | xargs -r git branch -d; }; f"Usage: git cleanup
Feature Branch Workflow
git config --global alias.feature "!f() { git checkout -b feature/$1; git push -u origin feature/$1; }; f"Usage: git feature new-login-system
- React 18 with modern hooks and functional components
- TypeScript for type safety and better developer experience
- Vite for fast development and optimized builds
- Lucide React for consistent iconography
- Custom CSS with responsive design principles
- Tauri for secure, lightweight desktop app framework
- Native Git integration via command-line interface
- OpenAI API client for AI-powered commit messages
- Cross-platform support for Windows, macOS, and Linux
- Secure local storage for API keys and settings
- Real-time validation of alias names and conflicts
- Live preview generation of Git alias commands
- Toast notifications for user feedback
- Responsive design that works on different screen sizes
- Error handling with helpful user messages
| Platform | Support Level | Notes |
|---|---|---|
| Windows | ✅ Full | Tested on Windows 10/11 |
| macOS | ✅ Full | Intel and Apple Silicon |
| Linux | ✅ Full | Ubuntu, Fedora, Arch tested |
- Local-first: All data stays on your machine
- Secure API storage: OpenAI keys encrypted locally
- No telemetry: We don't track your usage
- Git permissions: Uses your existing Git credentials
- Open source: Full transparency in our code
We welcome contributions from the community! Whether you're fixing bugs, adding features, or improving documentation, your help is appreciated.
- Fork the repository on GitHub
- Clone your fork locally
- Create a feature branch:
git checkout -b feature/amazing-feature - Make your changes and test thoroughly
- Commit with descriptive messages:
git commit -m "Add amazing feature" - Push to your fork:
git push origin feature/amazing-feature - Open a Pull Request with a clear description
- 🧪 Testing: Unit tests and integration tests
- 🌐 Internationalization: Multi-language support
- ♿ Accessibility: Keyboard navigation and screen readers
- 📱 UI/UX: Design improvements and user experience
- 🐛 Bug fixes: Edge cases and error handling
- 📚 Documentation: Tutorials and better examples
See our Contributing Guide for detailed information about development setup, coding standards, and the contribution process.
This project is licensed under the MIT License - see the LICENSE file for details.
- Tauri Team for the excellent desktop app framework
- React Team for the fantastic UI library
- Rust Community for the robust programming language
- OpenAI for the powerful API that enables AI features
- Git for being the amazing version control system we all love