even-better-commits
A CLI tool that helps you write better, faster, and more consistent commit messages with the power of AI!
Why?
Writing great commit messages is hard. even-better-commits makes it easy! It suggests commit messages based on your changes while strictly following the Conventional Commits specification. This ensures compatibility with tools like semantic-release and helps teams maintain consistency in their commit history.
Prerequisites
- Node.js v22 or higher
- GitHub CLI (optional; not needed for basic commits)
Installation
npm i -g even-better-commitsUsage
even-better-commits offers multiple commands for different use cases: creating commits, creating branches, and opening pull requests.
First-time Usage? No worries! even-better-commits will guide you through the initial configuration automatically. You can also run ebc-setup anytime to update your settings.
Creating a commit
ebcCreating a Branch
The GitHub CLI (gh) is required for this command.
This command creates a new branch based on a GitHub issue. The issue information is used to generate a descriptive branch name.
ebb
ebc-branchOpening a Pull Request
The GitHub CLI (gh) is required for this command.
This command opens a pull request based on the commit messages in the current branch. It generates a title and a short overview of the changes, including a list of commits with brief descriptions.
ebp
ebc-prAI Providers
even-better-commits supports multiple AI-powered commit message generation providers:
Ollama (Local)
If you have Ollama installed, you can use any available local model—no extra setup required!
SAP AI Core
To use SAP AI Core, set your credentials via the AICORE_SERVICE_KEY environment variable:
export AICORE_SERVICE_KEY='{
"url": "",
"clientid": "",
"clientsecret": "",
"serviceurls": { "AI_API_URL": "" }
}'Inspiration
This project is inspired by better-commits, a tool we love and use daily. Our goal? Keep it simple, but make it even better—so developers can focus on coding instead of writing commit messages.
Happy committing!