🤖 Stop Writing Boring Commit Messages. Let a Local AI Do It for You.

How many times have you typed git commit -m "fix stuff" or git commit -m "wip" because you just wanted to push your code and grab a coffee?

Writing great, meaningful commit messages is a hallmark of a good developer. It helps your team, makes code reviews easier, and keeps your project history clean. But let’s be honest: when you’re deep in the zone, writing a perfect installed and a local model pulled down. We recommend any of these depending on your system specs:

# High quality (Recommended)

ollama pull qwen2.5:7b



# Great balance

ollama pull mistral:7b



# Blazing fast / Resource friendly

ollama pull llama3.2:3b

2. Installation

You can install komit using your preferred method:

Via pipx (Recommended for Python CLI tools):

pipx install komit

Via Shell Script (Linux/macOS):

curl -fsSL https://raw.githubusercontent.com/glemiu6/komit/master/scripts/install.sh | bash

Via PowerShell (Windows):

irm https://raw.githubusercontent.com/glemiu6/komit/master/scripts/install.ps1 | iex

3. Pro-Tip: Create a Git Alias

Make your life even easier by aliasing it directly in git:

git config --global alias.ai '!komit'

Now, your workflow becomes:

git add .

git ai

⚙️ Customization & Styles

By running komit init, the tool sets up a global configuration file (~/.config/komit/config.toml) where you can tweak your default model, timeout limits, and preferred output style.

Here is what the different styles look like:

Conventional (Default)

feat(auth): add user authentication [feature/login]

Simple

Add user authentication [feature/login]

Detailed

feat(auth): add user authentication [feature/login]

- Add JWT token generation pipeline

- Implement password security layers using bcrypt primitives

- Append rotation verification routes

🛡️ Open Source & Contributing

komit is fully open-source under the Apache License 2.0. If you want to check out the code, report a bug, or add a feature, feel free to drop by the repository!

👉 Check out komit on GitHub

Give it a spin, and let me know in the comments: Do you trust AI to write your commit messages, or are you a commit-message purist? 👇