Revisor - Your local AI-powered commit reviewer

Revisor is a local, privacy-first AI assistant that helps developers understand incoming commits before merging them. Controlled directly from your terminal with a single command, Revisor fetches the latest remote changes, analyzes the diff against your local branch, and runs it through a local AI model to generate a structured review. The final report is displayed instantly inside VS Code as a side-by-side Markdown document.

Features

• Terminal Workflow: Trigger code reviews straight from your regular terminal using a native Git alias.
• Local & Private: Your source code never leaves your machine. All analysis is performed entirely on your local hardware.
• Smart Pre-Merge Sight: Automatically executes a git fetch background pipeline to see what has changed on the remote branch without polluting your current working state.
• Rich Markdown Reports: Displays a clean review panel highlighting summaries, breaking changes, and structural risks.

How It Works

Once installed, Revisor injects a lightweight global script wrapper into your Git configuration.

Before your first review, you will need to select your preferred AI model:

1. Open the VS Code Command Palette (Ctrl+Shift+P / Cmd+Shift+P).
2. Search for "Revisor: Switch AI Model".

Revisor will automatically provision a dedicated custom model based on your selection to handle the report generation. You can change this active model at any time.

When you run git revisor in your terminal, the extension uses a local file-bridge pipeline (pending-args.txt) to securely pass environment metrics from your shell directly to the VS Code Extension Host, seamlessly bypassing traditional CLI-to-editor limitations.

Requirements

Revisor relies on Git and a local AI engine to guarantee complete data security.

1. Install Ollama: Download and run Ollama on your machine.
2. Pull a Coding Model: Open your terminal and download a model optimized for code intelligence. Depending on your machine's hardware, we recommend:
   • Lightweight (8GB RAM, no dedicated GPU): ollama pull qwen2.5-coder:1.5b (Note: The 1.5B parameter limit restricts deep reasoning. Use this primarily for simple, everyday changes rather than complex architectural reviews.)
   • Standard (16GB RAM, 6GB+ VRAM): ollama pull deepseek-coder-v2:lite
   • High performance (32GB RAM, 10GB+ VRAM): ollama pull qwen2.5-coder:14b
3. Start Ollama: Run ollama serve in your terminal.

Usage

Open your terminal in any active Git repository and type:

git revisor <remote> <localBranch> <remoteBranch>

Known Limitations

• Review quality depends on the model selected. Smaller models (1.5b) may produce shallow or inconsistent analysis. For best results use qwen2.5-coder:7b or larger.
• The extension requires Ollama to be running before VSCode starts. If you start VSCode before ollama serve, restart the extension host via Developer: Restart Extension Host from the command palette.
• Currently built and optimized for Windows. MacOS and Linux support are not tested.
• Very large diffs (500+ lines) are trimmed before being sent to the model to avoid context window limits.

Known Issues

None

1.0.0

Initial release of Revisor

Thank you for choosing Revisor!