🤖 ai-diff — AI-Powered Code Review CLI

Review your git diffs with AI. Find bugs, security vulnerabilities, and code quality issues before they hit production.

---

✨ Features

• 🔍 AI-Powered Analysis — Reviews your git diffs using any OpenAI-compatible LLM
• 🐛 Bug Detection — Catches logical errors, edge cases, and runtime issues
• 🔒 Security Scanning — Identifies hardcoded secrets, injection risks, PII leaks, and more
• 💡 Actionable Suggestions — Gets refactoring ideas and best practice improvements
• 📊 Quality Score — Scores your code from 0–100 with clear breakdown
• 🎨 Beautiful Output — Color-coded, human-readable terminal output with severity indicators
• ⚙️ Configurable — Multiple LLM providers, strictness levels, output formats
• 📋 Commit Suggestions — Generates conventional commit messages from your changes

---

🚀 Installation

# Install via npm
npm install -g ai-diff

# Or run directly with npx
npx ai-diff

---

🔑 Setup

You need an API key from an OpenAI-compatible provider:

# Option 1: Environment variable
export AI_DIFF_API_KEY=sk-your-key-here
export AI_DIFF_MODEL=gpt-4o

# Option 2: Config file
ai-diff config --api-key sk-your-key-here --model gpt-4o

# Option 3: Use OPENAI_API_KEY (auto-detected)
export OPENAI_API_KEY=sk-your-key-here

Popular Providers

Provider	Base URL	Example Model
OpenAI	https://api.openai.com/v1	gpt-4o, gpt-4o-mini
Anthropic	https://api.anthropic.com/v1	claude-sonnet-4-6
Groq	https://api.groq.com/openai/v1	llama-3.3-70b
Together	https://api.together.xyz/v1	deepseek-ai/DeepSeek-V3
Ollama (local)	http://localhost:11434/v1	deepseek-coder

# Example: Use Groq for fast reviews
ai-diff config --base-url https://api.groq.com/openai/v1 --model llama-3.3-70b

---

📖 Usage

Review Staged Changes (Default)

# Stage your changes first
git add .

# Review them
ai-diff review
# or simply:
ai-diff

Review Specific Commit

ai-diff review --commit HEAD
ai-diff review --commit abc1234

Review Unstaged Changes

ai-diff review --unstaged

Output Formats

# Detailed (default) — full color-coded output
ai-diff review

# Concise — compact summary
ai-diff review --format concise

# JSON — machine-readable output
ai-diff review --format json | jq '.score'

Configuration Options

# View current config
ai-diff config --show

# Set API key
ai-diff config --api-key sk-...

# Set model
ai-diff config --model gpt-4o

# Set strictness level
ai-diff config --strictness aggressive

# Set temperature
ai-diff config --temperature 0.5

# Interactive setup wizard
ai-diff init

---

📋 Example Output

╔══════════════════════════════════════════╗
║       🤖 AI-DIFF — CODE REVIEW          ║
╚══════════════════════════════════════════╝

Scope: staged changes
Files changed: 3
+42 -12

  ~ src/index.ts        +20 -5
  + src/ai.ts           +15 -0
  ~ src/config.ts       +7 -7

📊 Code Quality Score: 85/100

📝 Summary:
Adds AI-powered code review functionality with OpenAI integration.

🐛 Issues:

  ⚠ [HIGH] Unhandled promise rejection in async review
    File: src/ai.ts:42
    The API call may throw without a catch handler.

🔒 SECURITY CONCERNS

  [HIGH] Hardcoded Secret — src/config.ts:15
    API key may be logged in error messages.
    → Sanitize error messages before logging.

---

⚡ Advanced

Custom API Base URL

For self-hosted or alternative providers:

# Local Ollama
ai-diff config --base-url http://localhost:11434/v1 --model deepseek-coder

# Azure OpenAI
ai-diff config --base-url https://your-resource.openai.azure.com --model gpt-4o

CI/CD Integration

# GitHub Actions — fail on critical issues
ai-diff review --format json | jq -e '.issues | map(select(.severity == "critical")) | length == 0'

Pre-commit Hook

Add to your .git/hooks/pre-commit:

#!/bin/sh
npx ai-diff review --format concise

---

🧪 How It Works

1. Extracts the git diff from your repository (staged, unstaged, or commit)
2. Sends the diff to an LLM with a structured review prompt
3. Parses the AI response into a structured review (issues, security, suggestions)
4. Displays the results with beautiful terminal formatting

Supports any OpenAI-compatible API — OpenAI, Anthropic, Groq, Together, Ollama, and more.

---

⚙️ Configuration Reference

Variable	Config Key	Default	Description
AI_DIFF_API_KEY	apiKey	—	API key for LLM provider
AI_DIFF_API_BASE_URL	apiBaseUrl	https://api.openai.com/v1	API base URL
AI_DIFF_MODEL	model	gpt-4o	Model name
—	strictness	balanced	conservative, balanced, or aggressive
—	temperature	0.3	LLM temperature (0–2)
—	maxDiffLines	2000	Max diff lines to send
—	format	detailed	Output format

---

🔧 Development

# Clone
git clone https://github.com/AFS-Agentics/ai-diff.git
cd ai-diff

# Install dependencies
npm install

# Build
npm run build

# Run locally
npm start -- review --help

---

🏗️ Built With

• TypeScript — Type-safe, modern JavaScript
• Commander — CLI framework
• Chalk — Terminal styling
• OpenAI SDK — LLM API client
• Simple Git — Git operations

---

📄 License

MIT © AFS Agentics

---

🤝 Contributing

Contributions are welcome! Feel free to open issues or submit PRs.

---

Made with ❤️ by AFS Agentics