Because your repository has commitment issues!
Kommit is a therapeutic approach to git commits, helping your codebase express itself through meaningful, conventional commit messages generated with AI.
Let's face it - most of us struggle with commitment issues when it comes to writing good git commit messages. We've all been there:
git commit -m "fixed stuff"
git commit -m "updates"
git commit -m "it works now"And who hasn't stared at that blinking cursor after git commit -m for what
feels like an eternity, mind suddenly blank, unable to summarize what you just
spent hours working on?
Your future self (and your teammates) deserve better. Kommit helps you write clear, meaningful commit messages that tell the real story of your changes.
- AI-Powered Analysis: Analyzes your staged changes and generates meaningful, conventional commit messages
- Relationship Counseling: Improves communication between you and future developers
- Emotional Intelligence: Helps your code express what it's really trying to do
- Commitment Structure: Follows conventional commit formats for better git history
- Scope Analysis: Suggests relevant scopes based on your project structure
- Self-Growth Options: Choose to accept the AI suggestion, request another, or write your own
brew install cowboy-bebug/tap/kommitPrerequisites:
- Go (1.24 or later required)
- Make
git clone https://github.com/cowboy-bebug/kommit.git
cd kommit
make installThis installs the kommit command-line tool.
Kommit requires an OpenAI API key to provide its therapeutic services:
# Set your OpenAI API key
export OPENAI_API_KEY="sk-..."
# Alternatively, you can use a dedicated key for Kommit
export KOMMIT_OPENAI_API_KEY="sk-..."🔐 Therapy Privacy: If both environment variables are set,
KOMMIT_OPENAI_API_KEYtakes precedence overOPENAI_API_KEY. This allows you to use a separate API key for Kommit if you prefer to keep your therapy sessions isolated from other OpenAI usage.
Begin your repository's healing journey:
git kommit initThis creates a .kommitrc.yaml configuration file. It'll analyze your project
structure and suggest meaningful scopes so your commits can finally express
themselves properly.
When you're ready to commit changes:
-
Stage your changes with
git add- focus on logically grouping related changes -
Start a therapy session:
git kommit
-
Review the AI-generated commit message
-
Choose to:
- Accept the message and commit
- Work through your commitment issues yourself (edit the message)
- Request another therapy session for a better message (re-run)
- Terminate the therapy session (exit without committing)
💡 Therapy Tip: The key to successful commit therapy is to stage logically related changes together. Instead of worrying about writing the perfect commit message, focus on what belongs together in a commit. Let Kommit handle translating your changes into meaningful messages - that's what your therapist is here for!
Kommit uses OpenAI's models to analyze your staged changes and generate meaningful commit messages following conventional commit formats. It's like couples therapy between you and your future self - improving how you communicate today so there's less confusion tomorrow.
The therapy process:
- Analyzes your staged changes
- Considers your project's context and scopes
- Generates a conventional commit message
- Gives you options for proceeding
- Handles the git commit process
After running git kommit init, you'll have a .kommitrc.yaml file with your
therapy plan:
llm:
model: gpt-4o-mini # Your therapist's qualifications
commit:
types:
- feat
- fix
- docs
# ... other conventional commit types
scopes:
- ui
- api
- auth
# ... project-specific scopesBefore therapy:
$ git commit -m "fixed the thing that was broken yesterday"
$ git log -1 --format=medium
commit a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0
Author: Developer Name <dev@example.com>
Date: Mon Mar 4 10:30:45 2023 -0800
fixed the thing that was broken yesterdayAfter therapy:
$ git kommit
$ git log -1 --format=medium
commit a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0
Author: Developer Name <dev@example.com>
Date: Mon Mar 4 10:30:45 2023 -0800
feat(auth): implement JWT token refresh mechanism
- Added token refresh endpoint to authentication service
- Implemented automatic refresh when token is near expiration
- Updated documentation with new token lifecycle
[Generated by Kommit]Your contributions to this therapeutic journey are welcome! Whether you're fixing bugs, adding features, or improving documentation, we appreciate your help in making git history a better place.
MIT - Because everyone deserves access to commit message therapy.
Remember: Good commit messages are like good apologies - specific, sincere, and they don't include the phrase "various changes". Your future self will thank you for the therapy.