AICommit 🤖

AI-powered commit message generator with support for multiple AI providers. Generate professional commit messages in Conventional Commits format.


✨ Features

- 🎯 Multiple AI Providers: Claude (Anthropic), GPT-4 (OpenAI), Gemini (Google)
- 📝 Conventional Commits: Automatic formatting in standard format
- ⚡ Quick Setup: Configure once and use forever
- 🎨 Interactive: Edit in console or git editor
- 💾 Local Configuration: API keys stored securely
- 🚀 Fast: Generate commit messages in seconds

🚀 Quick Start

$3

``bash
npm install -g @committools/aicommit
`

$3

`bash
aicommit --setup
`

You'll see an interactive menu to configure:
- Default AI provider selection
- API keys input
- Auto-commit behavior

$3

`bash


Stage your files

git add .

Generate commit message

aicommit

Or with specific provider

aicommit --provider openai

Or with git editor

aicommit --editor

Short alias

aic
`

📖 Detailed Usage

$3

`bash
aicommit # Generate commit for staged changes
aicommit --provider claude # Use Claude (for this run only)
aicommit --provider openai # Use GPT-4 (for this run only)
aicommit --provider gemini # Use Gemini (for this run only)
aicommit --set-provider openai # Change default provider permanently
aicommit --branch main # Compare with main branch
aicommit --editor # Open in git editor
aicommit --setup # Configure API keys
aicommit --config # Show current configuration
aicommit --help # Show help

Short alias (all same options work)


aic
aic --set-provider claude
`

$3

#### Claude (Anthropic) - Recommended ⭐

1. Go to https://console.anthropic.com/
2. Create account or sign in
3. Navigate to API Keys
4. Create new key
5. Cost: ~$3 per million tokens

#### OpenAI (GPT-4)

1. Go to https://platform.openai.com/
2. Create account
3. Navigate to API keys
4. Create new key
5. Cost: ~$10 per million tokens

#### Google Gemini - Free 🎉

1. Go to https://makersuite.google.com/app/apikey
2. Sign in with Google account
3. Create API key
4. Cost: Free up to 60 requests/minute

$3

`bash
$ git add .
$ aicommit

🤖 AICommit Generator

✓ Found changes in 3 file(s)
Files: src/auth.js, src/middleware.js, tests/auth.test.js

✓ Commit message generated!

============================================================
Generated Commit Message:
============================================================
feat(auth): Add JWT authentication system

Implement complete JWT-based authentication to replace the
legacy session-based approach. This improves scalability and
enables stateless authentication across distributed services.

- Add JWT token generation and validation middleware
- Implement refresh token rotation mechanism
- Create authentication endpoints (login, logout, refresh)
- Add password hashing with bcrypt
- Update user model with token-related fields
- Add comprehensive authentication tests
============================================================

? What would you like to do?
✓ Commit with this message
✏️ Edit in git editor
📋 Copy to clipboard
❯ ❌ Cancel
`

⚙️ Configuration

Configuration file is stored at ~/.aicommit/config.json

`json
{
"defaultProvider": "claude",
"apiKeys": {
"anthropic": "sk-ant-...",
"openai": "sk-...",
"gemini": "..."
},
"autoCommit": false
}
`

$3

Instead of storing in config, you can use environment variables:

`bash
export ANTHROPIC_API_KEY="sk-ant-..."
export OPENAI_API_KEY="sk-..."
export GEMINI_API_KEY="..."
`

🎯 Conventional Commits Format

The tool generates commits in standard format:

`
():