CommitGen

AI-powered conventional commit message generator using Google Gemini (FREE).

Setup

1. Install:

   npm install -g commit-gen

2. Get FREE Gemini API key:

   • Visit: https://aistudio.google.com/app/apikey
   • Click "Create API Key"
   • Copy the key

3. Configure:

   commit-gen config
   # Paste your API key when prompted

4. Use:

   git add .
   commit-gen

Features

• AI-powered commit messages using Google Gemini
• Conventional commit format (feat, fix, refactor, etc.)
• Uses FREE Gemini API
• Interactive selection with 3 suggestions
• Beautiful terminal UI with colors and spinners
• Large diff warnings
• Configurable preferences

Commands

• commit-gen - Generate and commit
• commit-gen config - Setup/change configuration
• commit-gen config --show - View current config
• commit-gen config --reset - Reset all configuration
• commit-gen --help - Show help
• commit-gen --version - Show version

How It Works

1. Stage your changes with git add
2. Run commit-gen
3. AI analyzes your diff and suggests 3 commit messages
4. Pick one (1-3), regenerate (r), or quit (q)
5. Auto-commits with your chosen message

Configuration

Config is stored at ~/.config/commit-gen-nodejs/config.json:

| Option | Default | Description | |--------|---------|-------------| | apiKey | - | Gemini API key (required) | | preferredTypes | [] (all) | Prioritize certain commit types | | maxDiffLines | 500 | Warn if diff exceeds this | | autoCommit | true | Auto-commit or just show message | | showExplanations | false | Show reasoning for suggestions |

License

MIT