commit-genie

Fast, local, AI-powered Git commit message generator. Light weight (if a bit slow)

Features

• ✏️ Generate commit messages from staged Git diffs
• 🤖 Works with local AI models (via Ollama)
• 🌐 Optional: Use OpenAI or Claude API
• 🔧 Supports Conventional Commits (--conventional)
• 🧑‍💻 Optional --commit flag to auto-commit
• 🧪 Built with TypeScript, lightweight, zero bloat
• ✅ Cross-platform (Windows/Linux/Mac)
• 📁 .commitgenrc.json for persistent config
• 📦 Tiny footprint, zero dependencies for core functionality

Global Installation

npm install -g @cavani21/commit-genie
# or
npx @cavani21/commit-genie --help

Usage

npx commit-genie

# Or manually:
git add .
commit-genie                 # Generates a commit message from staged changes
commit-genie --commit        # Also commits it
commit-genie --conventional  # Format as Conventional Commit

Example Output

feat: add initial CLI support with local AI (Ollama)

Config

You can save settings in a .commitgenrc.json file:

{
  "provider": "ollama",
  "model": "mistral",
  "conventional": true
}

License

MIT © 2025 cavani21