# GitWarren

Provides local code review for coding agents before commits are created. Agents inspect diffs, read line comments, and answer feedback directly.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 18
- Author: klarluft
- License: GPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/klarluft/gitwarren-app
- Updated: 2026-10-14
- HTML: https://affpapa.org/en/nevibecode/mcp/gitwarren

## What it does

GitWarren lets you inspect local modifications the moment an assistant edits your files. It links directly to git working trees over stdio. Staged, unstaged, and untracked files appear combined into one diff view. You catch mistakes before committing anything.

The review interface runs as an Electron desktop app or inside a browser tab. Every comment and review record is kept on your machine in an SQLite database file. No cloud accounts exist. Running the CLI via `npx` requires Node 22.14 or later.

Agents interact with reviews through MCP tools. When you comment on a specific code line or a Markdown paragraph, the agent reads your note, edits the source, and marks the item resolved.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `GITWARREN_DATA_DIR` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env GITWARREN_DATA_DIR=<GITWARREN_DATA_DIR> --transport stdio gitwarren -- npx -y gitwarren
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add gitwarren --env GITWARREN_DATA_DIR=<GITWARREN_DATA_DIR> -- npx -y gitwarren
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "gitwarren": {
            "command": "npx",
            "args": [
                "-y",
                "gitwarren"
            ],
            "env": {
                "GITWARREN_DATA_DIR": "<GITWARREN_DATA_DIR>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "gitwarren": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "gitwarren"
            ],
            "env": {
                "GITWARREN_DATA_DIR": "<GITWARREN_DATA_DIR>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e GITWARREN_DATA_DIR=<GITWARREN_DATA_DIR> gitwarren npx -y gitwarren
```
Replace <…> with your own values

## When to use it
- inspect uncommitted assistant edits before creating a commit
- add line comments for the agent inside a pull-request interface
- let the model resolve review discussions directly in thread
- review Markdown changes side by side with rendered visual edits

## Example prompts
- Open a GitWarren review for my current worktree changes
- Check my comments on the latest diff and fix the flagged issues
- List unresolved review threads in this repository

## Similar
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [Serena MCP: the IDE for your agent](https://affpapa.org/en/nevibecode/mcp/serena-mcp-the-ide-for-your-agent.md) — MCP server · ★ 30677
- [Repomix](https://affpapa.org/en/nevibecode/mcp/repomix.md) — MCP server · ★ 29027
- [Repowise](https://affpapa.org/en/nevibecode/mcp/repowise.md) — MCP server · ★ 7891
- [sem](https://affpapa.org/en/nevibecode/mcp/sem.md) — MCP server · ★ 3422

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md