matecommit

MateCommit

I built this because I honestly couldn't be bothered to think of a name for every single commit.

Quick Start • Features • Documentation • Contributing

Why MateCommit?

You know that feeling when you've been coding for hours, your brain is fried, and you're staring at the terminal unable to describe what you just did? I do.

Writing good commit messages and PR descriptions is important, but it's often the last thing you want to do when you're tired. MateCommit was born out of that frustration. It reads your changes and suggests clear, meaningful messages using AI (Google Gemini), so you can focus on the code and leave the creative writing to the models.

It handles the boring parts of the workflow:

• Writing conventional commit messages.
• Summarizing PRs with test plans and breaking changes.
• Creating JIRA tickets from your changes.
• Managing releases, SemVer, and changelogs.

Demo

$ matecommit suggest

Analyzing changes...
Found 3 files changed, 127 insertions, 45 deletions

Suggestions:
1. feat(auth): implement JWT-based authentication with refresh tokens
2. feat: add user authentication system with JWT support
3. feat(api): integrate JWT authentication middleware for secure endpoints

Select a suggestion (1-3): 1
Committed: feat(auth): implement JWT-based authentication with refresh tokens

Quick Start

1. Install

You'll need Go installed on your machine:

go install github.com/thomas-vilte/matecommit/cmd/matecommit@latest

2. Configure

Set up your Gemini API key (it takes 10 seconds):

matecommit config quick

3. Use it

Stage your changes and let the tool do the work:

matecommit suggest

What it actually does

While there are other tools out there, I built MateCommit to be a complete workflow tool, not just a message generator.

Main Features

• Smart Commits: It analyzes the full diff context, not just filenames. It can also take context from a specific issue number to be more precise.
• PR Automation: Use matecommit spr <id> to generate a full executive summary, test plan, and detect breaking changes automatically.
• Issue Management: Generate issues directly from your code changes or descriptions. It even supports Jira integration and can auto-checkout branches for you.
• Releases: An interactive wizard that analyzes your commits since the last tag, suggests the next version bump, and writes the changelog for you.
• Developer Experience: Includes shell autocompletion (bash, zsh, fish) and a doctor command to make sure your integrations are working correctly.

How It Works

┌─────────────┐
│  Your Code  │
└──────┬──────┘
       │
       ▼
┌─────────────────┐
│  Git Diff       │ ──▶ Analyzes changes
└─────────┬───────┘
          │
          ▼
┌─────────────────┐
│  AI Provider    │ ──▶ Google Gemini
└─────────┬───────┘
          │
          ▼
┌─────────────────┐
│  MateCommit     │ ──▶ Generates suggestions
└─────────┬───────┘
          │
          ▼
┌─────────────────┐
│  Your Choice    │ ──▶ Select and commit
└─────────────────┘

Tech Stack:

• Language: Go (fast, single binary).
• AI: Google Gemini (OpenAI and Claude support is coming).
• Platforms: GitHub (VCS) and Jira (Tickets).

Roadmap

Stuff I'm planning to add soon:

• Local LLMs: Support for Ollama so you can use it for free/offline.
• More Providers: OpenAI and Claude integration.
• Code Review: AI-powered feedback before you even commit.
• GitLab/Bitbucket: Support for other platforms.

Contributing

MateCommit is open source, and I'd love to have more people involved. Whether it's adding a new AI provider, fixing a bug, or just improving the templates, all help is welcome.

Check out CONTRIBUTING.md to see how to get started.

License

MIT License - see LICENSE for details.