diffai

DiffAI

A lightweight command-line tool that provides a simple way to ask questions about commits, staged changes, or diffs through seamless integration between Git and AI.

⚠️ Early Development Notice
This project is in early development. Features may change, break, or be incomplete. Use at your own risk.

Features

• AI-Powered Diff Review: Get intelligent feedback on your Git diffs using multiple LLM providers
• Flexible Git Integration: Review staged changes, specific commits, or compare branches
• Interactive Chat Mode: Engage in conversations about your code changes
• Multiple LLM Providers: Support for various AI providers and models
• Customizable Prompts: Easily switch between custom review instructions
• Diff Filtering: Focus reviews on specific files or paths

Installation

1. Download the latest release

You can manually download the binary from the Releases page, or use the terminal:

# Set desired version and platform
VERSION="0.1.0"         # replace with the version you want
OS="linux"              # "darwin" for macOS
ARCH="amd64"            # "arm64" or "i386" if needed

# Download the binary archive
TAR_NAME="diffai_${OS}_${ARCH}.tar.gz"
curl -LO "https://github.com/klemjul/diffai/releases/download/v${VERSION}/${TAR_NAME}"

1. Verify the download

# Download the corresponding checksum file
CHECKSUM_NAME="diffai_${VERSION}_checksums.txt"
curl -LO "https://github.com/klemjul/diffai/releases/download/v${VERSION}/${CHECKSUM_NAME}"

# Verify the integrity of the downloaded archive
sha256sum --check --ignore-missing $CHECKSUM_NAME

1. Move binary

# Extract the archive
tar -xzf "$TAR_NAME"

# Make the binary executable and move it to your PATH
chmod +x diffai
sudo mv diffai /usr/local/bin/

Usage

Review git reference(s) with AI

Usage:
  diffai <commit1> [commit2] [flags]

Examples:

diffai main dev   # Review diff of two branches
diffai abc123 def456   # Review diff of two commits
diffai cdce10   # Review diff of a commit
diffai   # Review diff of staged changes


Flags:
  -p, --prompt string          Includes review instructions as system prompt. (env: DIFFAI_PROMPT)
                               - If <value> is a string, it will override the default and be used directly as the instructions.
                               - If <value> is a number, it will look for the environment variable DIFFAI_PROMPT_<number> instead.

      --provider string        LLM provider to use. (env: DIFFAI_PROVIDER)
      --model string           LLM model to use, depends on the provider. (env: DIFFAI_MODEL)
  -i, --interactive            Run diffai in Chat Mode.
      --diff-token-limit int   Maximum number of tokens for the diff content. (env: DIFFAI_DIFF_TOKEN_LIMIT) (default 100000)
  -f, --diff-filters strings   git diff -- <path> filters, used to limit the diff to the named paths or file exts
  -h, --help                   help for diffai

Configuration

DiffAI can be configured through environment variables or command-line flags.

Environment Variables

export DIFFAI_PROVIDER="openai"
export DIFFAI_MODEL="gpt-4.1"
export DIFFAI_PROMPT="Review this code for bugs, security issues, and best practices"
export DIFFAI_DIFF_TOKEN_LIMIT="200000"

Predefined Prompts

You can use numbered prompts by setting environment variables.

export DIFFAI_PROMPT_1="Focus on security vulnerabilities"
export DIFFAI_PROMPT_2="Review for performance optimizations"
export DIFFAI_PROMPT_3="Check code style and maintainability"

Then use them with

diffai -p 1  # Uses DIFFAI_PROMPT_1

Supported LLM Providers

openai and ollama

License

DiffAI is licensed under the MIT License. See the LICENSE file for details.

Contributing

See CONTRIBUTING.md for documentation on how to contribute code.

Report Problems

If you have what looks like a bug, please use the GitHub issue tracking system. Before you file an issue, please search existing issues to see if your issue is already covered.