CommitPilot

AI powered Git commit and PR description generator.

CommitPilot analyzes staged git changes and generates high quality commit messages using AI.

Supports multiple AI providers including OpenAI, Groq, Anthropic, DeepSeek, Google Gemini, and free local models via Ollama.

📦 npm package: https://www.npmjs.com/package/@milandadhaniya/commitpilot

Features

• AI generated commit messages
• Commit title + detailed description
• Pull request title and description generation
• Conventional commit format
• Multiple AI providers with model selection
• Free local AI support via Ollama
• Provider URLs and models managed from a single providers.json file
• Interactive CLI

Installation

Install globally

npm install -g @milandadhaniya/commitpilot

Or run with npx

npx @milandadhaniya/commitpilot

First Time Setup

Run:

commitpilot

You will be prompted to:

1. Choose an AI provider
2. Enter your API key (not required for Ollama)
3. Choose a model for that provider

Configuration is stored at:

~/.commitpilot/config.json

Update Provider, Model or API Key

Run:

commitpilot config

This re-runs the setup prompts and lets you switch to a different provider, pick a different model, or update your API key. The new configuration overwrites ~/.commitpilot/config.json.

You can also edit the file directly:

~/.commitpilot/config.json

Generate Commit Message

Stage your changes first:

git add .

Then run:

commitpilot

Example output:

────────────────────────────────────────────────────────────

Suggested commit:

feat(auth): implement refresh token authentication

* Added refresh token endpoint
* Updated JWT middleware
* Improved token validation logic

────────────────────────────────────────────────────────────

What would you like to do?
❯ Use this message
  Edit message
  Cancel

Choose from three options:

• Use this message - Creates the commit with the AI-generated message
• Edit message - Opens your default editor to modify the message before committing
• Cancel - Aborts the commit

Generate PR Description

commitpilot pr

Example output:

PR Title:
feat(auth): implement refresh token authentication

PR Description:

Summary
Adds refresh token based authentication flow.

Changes

* Added refresh token endpoint
* Updated JWT middleware
* Improved validation logic

Supported Providers

| Provider | Models (examples) | API Key required | |-----------|----------------------------------------------------------|------------------| | OpenAI | gpt-4o, gpt-4o-mini, gpt-4-turbo, gpt-3.5-turbo | Yes | | Anthropic | claude-opus-4-5, claude-sonnet-4-5, claude-3-haiku | Yes | | Groq | llama-3.3-70b-versatile, mixtral-8x7b, gemma2-9b-it | Yes | | DeepSeek | deepseek-chat, deepseek-reasoner | Yes | | Gemini | gemini-2.0-flash, gemini-1.5-pro, gemini-1.5-flash | Yes | | Ollama | llama3, llama3.2, mistral, codellama, phi3, gemma2 | No |

Free Local AI with Ollama

Install Ollama from https://ollama.com, then pull a model:

ollama run llama3

Select ollama as your provider during setup. No API key needed.

Customizing Providers

All provider URLs and available models are defined in src/providers.json. To update an endpoint or add a new model, just edit that file — no code changes needed.

Example entry:

"openai": {
  "url": "https://api.openai.com/v1/chat/completions",
  "models": ["gpt-4o", "gpt-4o-mini", "gpt-4-turbo", "gpt-3.5-turbo"]
}

To add a new provider, add an entry to providers.json and create a corresponding file in src/providers/.

Roadmap

• Auto commit mode
• Git hooks integration
• GitHub PR creation
• Commit lint validation
• AI code explanation

License

MIT