GitWarren — Claude Code MCP server: what it does, how to install
Provides local code review for coding agents before commits are created. Agents inspect diffs, read line comments, and answer feedback directly.
claude mcp add --env GITWARREN_DATA_DIR=<GITWARREN_DATA_DIR> --transport stdio gitwarren -- npx -y gitwarrenWhat GitWarren 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.
What it helps with
- 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 for the agent
- 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
How to install GitWarren
Platform CLI
claude mcp add --env GITWARREN_DATA_DIR=<GITWARREN_DATA_DIR> --transport stdio gitwarren -- npx -y gitwarrenReplace <…> with your own values
Platform CLI
codex mcp add gitwarren --env GITWARREN_DATA_DIR=<GITWARREN_DATA_DIR> -- npx -y gitwarrenReplace <…> with your own values
Config file
{
"mcpServers": {
"gitwarren": {
"command": "npx",
"args": [
"-y",
"gitwarren"
],
"env": {
"GITWARREN_DATA_DIR": "<GITWARREN_DATA_DIR>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"gitwarren": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"gitwarren"
],
"env": {
"GITWARREN_DATA_DIR": "<GITWARREN_DATA_DIR>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e GITWARREN_DATA_DIR=<GITWARREN_DATA_DIR> gitwarren npx -y gitwarrenReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about GitWarren
How to install GitWarren in Claude Code?
Run claude mcp add --env GITWARREN_DATA_DIR=<GITWARREN_DATA_DIR> --transport stdio gitwarren -- npx -y gitwarren. Replace <GITWARREN_DATA_DIR> with the folder path for the local SQLite database.
What does GitWarren do?
It gives you a pull-request-style interface for local git branches and worktrees. Agents can open comparisons, read inline comments, and post replies.
Does GitWarren send code or reviews to external servers?
Everything stays on your local device. Comments and metadata are kept in a single SQLite file, with no external telemetry or accounts.
