Based on gh-standup by Sean Goedecke.
A GitHub CLI extension that generates AI-powered conventional commit messages using staged git changes from current repository. It uses free GitHub Models for inference, so you don't need to do any token setup - your existing GitHub CLI token will do fine!
If you find this utility useful, check my another tool – gh-repomon.
gh extension install hazadus/gh-commitmsg
gh commitmsg
To ensure the GitHub CLI can access your organization's data:
# Authenticate with GitHub CLI (if not already done)
gh auth login
# Authenticate with your organizations
gh auth refresh -h github.com -s read:org
Generate a commit message for the staged changes:
# Stage changes in git repo
git add .
# Generate commit message
gh commitmsg
You can use and combine different options:
# Use different language
gh commitmsg --language russian
# Use previous commit messages as examples for LLM (default: 3, max: 20)
gh commitmsg --examples
# Or specify custom number of examples
gh commitmsg --examples 5
# Use a different AI model
gh commitmsg --model xai/grok-3-mini
Upgrading Extension to Latest Version
# Use to upgrade commitmsg to latest version
gh extension upgrade commitmsg
LLM will generate something like:
feat: add CI/CD workflows, license, and update project details
- Introduced .github/workflows/ci.yml:
- Added CI pipeline for testing, building, and artifact upload.
- Configured matrix builds for multiple OS/architectures.
- Added .github/workflows/release.yml:
- Automated release process triggered by version tags.
- Builds binaries for Linux, macOS, and Windows.
For more examples, see commit messages in this repo.