🚀 Elevate Your Workflow

GitMateAI isn't just a CLI tool; it's your pair programmer in the terminal. By integrating state-of-the-art LLMs directly into your git workflow, it transforms mundane tasks into intelligent actions.

• ✍️ Smart Commits: Generate semantic, conventional commit messages from your changes instantly.
• 🧐 Deep Reviews: Get AI-powered code reviews that catch security flaws and logic errors before you push.
• 📝 Instant PRs: Draft comprehensive Pull Request descriptions that summarize your work perfectly.
• 🔒 Security First: Built-in secret scanning ensures you never leak an API key again.

⚡ Quick Start

Get up and running in seconds.

Prerequisites

• Node.js >= 16.0.0
• Git installed and configured

1. Install

npm install -g gitmate-ai

2. Initialize

cd your-project
gitmate init

3. Configure

Set your API key for your preferred provider (OpenAI, Anthropic, Gemini, Groq, etc.).

# Example: Using OpenRouter
export OPENROUTER_API_KEY="your-key-here"
gitmate model --set openrouter

4. Commit

Stage your files and let GitMateAI handle the rest.

git add .
gitmate commit

💎 Core Features

gitmate commit

Analyze your staged changes and generate a commit message that follows Conventional Commits.

• Context-Aware: Understands the difference between a fix, feat, and chore.
• Interactive: Review and edit the message before confirming.

gitmate review

Run a local code review on your changes.

• Security Scanning: Detects hardcoded secrets and vulnerabilities.
• Quality Checks: Identifies anti-patterns and suggests refactors.
• Performance: Flags potential bottlenecks.

gitmate pr

Generate a structured Pull Request description based on the commits in your branch.

• Summaries: Automatically summarizes changes.
• Testing Notes: Suggests testing steps based on code modified.

gitmate model

Switch between 11+ AI providers instantly.

• Flexible: Use GPT-5 for complex reviews and Llama 4 for fast commits.
• Cost-Effective: Support for free-tier models from Groq, Gemini, and Ollama.

🧠 Supported Intelligence

GitMateAI is provider-agnostic. Use the best model for the job.

| Provider | Best For | Recommended Model | |----------|----------|-------------------| | Anthropic | Coding & Reasoning | claude-opus-4.5 | | OpenAI | Complex Analysis | gpt-5.1-codex | | Google | Speed & Context | gemini-3.0-pro | | Groq | Lightning Fast Commits | llama-4-maverick | | OpenRouter | Maximum Choice | Access to 100+ models | | Ollama | Local Privacy | codellama, mistral |

Note: We also support Mistral, HuggingFace, xAI, Together AI, and Replicate.

🛠 Configuration

Customize GitMateAI to fit your team's style. The gitmate init command creates a .gitmate.config.json file:

{
  "ai": {
    "provider": "openrouter",
    "model": "anthropic/claude-3.5-sonnet",
    "temperature": 0.3
  },
  "commit": {
    "conventionalFormat": true,
    "maxLength": 72,
    "emojis": true
  },
  "security": {
    "enableSecretsDetection": true
  }
}

🤝 Contributing

We believe in the power of open source. If you have ideas for new features or improvements, we'd love to hear from you.

1. Check out the Contributing Guide.
2. Browse Issues for help wanted.
3. Submit a Pull Request!

📄 License

GitMateAI is open-source software licensed under the MIT License.