GitConventionalCommit is a macOS application designed to simplify the creation of standardized commit messages following the Conventional Commits specification. It provides a user-friendly interface for managing Git repositories and creating well-formatted commit messages with appropriate types, scopes, and emoji icons.
- Conventional Commit Format: Create standardized commit messages with proper type, scope, and description
- Emoji Support: Add visual context to commits with relevant emoji icons
- Git Integration: Perform common Git operations directly from the app
- Stage/unstage files
- Discard changes
- Commit changes
- Pull/push changes
- View commit history
- File Management: View and manage staged, unstaged, and untracked files
- Recent Repositories: Quick access to recently opened repositories
- External Editor Support: Can be used as an external editor for Git commit messages
The application supports the following conventional commit types:
- feat: A new feature
- fix: A bug fix
- docs: Documentation changes
- style: Changes that do not affect the meaning of the code
- chore: Other changes that don't modify source or test files
- refactor: Code changes that neither fix a bug nor add a feature
- revert: Reverts a previous commit
- perf: Performance improvements
- test: Adding or correcting tests
- build: Changes to the build system or dependencies
- ci: Changes to CI configuration files and scripts
Each commit can include a scope with an associated emoji to provide visual context:
- π Init - Initial commit
- β¨ New - New features
- π‘ Idea - New ideas or concepts
- π Pin - Pin dependencies
- β Add - Add files or dependencies
- β Remove - Remove files or dependencies
- π Delete - Delete files or code
- βοΈ Edit - Edit files or code
- π§ Working - Work in progress
- β Done - Completed tasks
- π Bug - Bug fixes
- π Doc - Documentation updates
- βΏοΈ Accessibility - Accessibility improvements
- π Style - UI/style updates
- π¨ Theme - Theme changes
- π§ Conf - Configuration changes
- βοΈ Settings - Settings changes
- π Performance - Performance improvements
- π¦ Package - Package updates
- π Delivery - Delivery changes
- π Deploy - Deployment changes
- βͺ Revert - Revert changes
- Download the latest release from the Releases page
- Move the application to your Applications folder
- Launch the application
- Open the application
- Choose a Git repository from the file picker or recent repositories list
- View and manage your repository files
- Create commits with the conventional format using the commit form
You can configure Git to use GitConventionalCommit as your default commit message editor:
git config --global core.editor "open -W -a GitConventionalCommit"- macOS 10.15 or later
- Git installed on your system
Contributions are welcome! Please feel free to submit a Pull Request.

