# GitWarren

> GitWarren is an open-source MCP server for developer tools. Local code review of an agent's uncommitted worktree, with a 17-tool MCP server. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Windows, Linux, CLI, Web, self-hosted
- **Website:** https://gitwarren.com
- **Repository:** https://github.com/klarluft/gitwarren-app
- **MCP Registry name:** io.github.klarluft/gitwarren
- **Categories:** developer tools
- **Listing updated:** 2026-11-15

## About

Most review tools wait for a pull request; GitWarren reads the worktree directly, folding staged, unstaged and untracked files into one diff so you can comment on an agent's output before it becomes a commit. It finds the worktree where a branch is checked out, wherever it sits on disk.

Reviews live in a single SQLite file on your machine, with no account and no telemetry; the README says the desktop app's only outbound request is the update check. It runs as an Electron app on macOS, Windows and Linux, or as a command (npx gitwarren serve) that serves the same interface to a browser. A screenless machine such as a VPS or WSL distro can be reviewed from elsewhere over SSH, wsl.exe or a tailnet.

The MCP server over stdio gives agents the same seventeen tools the app uses: open a review, read the discussion, reply in a thread, comment on a line and resolve one. Diffs can be split or unified with changed words marked, Markdown can be read rendered with edits shown like tracked changes, and a progress strip tracks which files you have read.

## Features

- **Pre-commit review:** Reads staged, unstaged and untracked changes straight from the worktree.
- **Prose-aware diffs:** Rendered Markdown with tracked-change style edits and word-level marks.
- **Review progress strip:** One slot per file, with reviewed and changed-since-read states.
- **Agent participation:** Agents reply in threads, comment on lines and resolve discussions over MCP.
- **Remote machines:** Review other machines over SSH, WSL or a tailnet from one home screen.
- **Local only:** Reviews are stored in a local SQLite file with no account.

## Good for

- Read an agent's diff before committing it
- Ask a coding agent to answer a question left on a line
- Review work happening on a VPS from your laptop
- Check a long spec or plan the agent wrote as rendered Markdown
- Browse a repository's uncommitted files

## Install

### Claude Code (Terminal)

```sh
claude mcp add gitwarren -- npx -y gitwarren
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "gitwarren": {
      "command": "npx",
      "args": [
        "-y",
        "gitwarren"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "gitwarren": {
      "command": "npx",
      "args": [
        "-y",
        "gitwarren"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "gitwarren": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "gitwarren"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "gitwarren": {
      "command": "npx",
      "args": [
        "-y",
        "gitwarren"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "gitwarren": {
      "command": "npx",
      "args": [
        "-y",
        "gitwarren"
      ]
    }
  }
}
```

## FAQ

### Does it need an account?

No. The README says there is no account and no telemetry.

### Where are reviews stored?

In one SQLite file in your application-data directory, or GITWARREN_DATA_DIR if set.

### How many MCP tools are there?

Seventeen, the same ones the app uses.

### Can it run without Electron?

Yes, npx gitwarren serve serves the interface to a browser; it needs Node 22.14 or newer.

### Is GitWarren free?

Yes. GitWarren is open source, so you can use and self-host it for free.

### How do I add GitWarren to Claude Code?

Run this command in your terminal: claude mcp add gitwarren -- npx -y gitwarren

### What are the best alternatives to GitWarren?

The closest alternatives to GitWarren are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/gitwarren
