gitwarren.com

mx

ns

michelle.ns.cloudflare.com

major.ns.cloudflare.com

caa

txt

google-site-verification=ZLZmxPBHSby6_m-FxU5esnKQOCSNYC2NU4gw5sYuc8c

dmarc

# Cloudflare prepends its managed block (content signals and AI-crawler
# disallows) to this file at the edge when "Manage robots.txt" is on for the
# zone. Turn that off in the dashboard if you want assistants such as ChatGPT
# and Claude to be able to read and recommend this page.

User-agent: *
Allow: /

Sitemap: https://gitwarren.com/sitemap-index.xml

# GitWarren

> A free, open-source (GPL-3.0) tool for local git code review on macOS, Windows and Linux — a desktop app, or a command that serves the same review UI into a browser tab. It reads the worktree directly — staged, unstaged and untracked changes — so you can review what an AI coding agent wrote on your own machine, before it becomes a commit or a pull request.

- Website and downloads: https://gitwarren.com
- Guides: https://gitwarren.com/docs
- Source code: https://github.com/klarluft/gitwarren-app
- Releases: https://github.com/klarluft/gitwarren-app/releases

## What it does

- Opens reviews against your local repositories, presented like a pull request: conversation, commits and files changed.
- Includes uncommitted work. If the branch under review is checked out in a worktree, its staged, unstaged and untracked files are folded into the diff.
- Shows the directory the branch under review is checked out in, the main checkout or a worktree, with buttons to copy the path and show it in the file manager.
- Reads a long diff well: unified or side-by-side, with only the changed words highlighted in an edited line; syntax highlighting with GitHub's grammars and light and dark themes; a wrap toggle for long lines; a light/dark switch beside the system default. Files are built as you scroll to them, so a diff of hundreds of files stays usable.
- Renders Markdown files as a preview with the changes marked in place, like tracked changes, and lets you comment on a paragraph from there. Relative links open the linked file and repository images are drawn.
- Tracks review progress per file: a "Reviewed" tick that clears itself if the file changes afterwards, and a strip above the diff with one slot per file.
- Browses a repository's files without a review, from the checkout on disk or any branch or tag, and searches a review's files with git grep.
- Works on a phone through the browser UI, over your tailnet, with review screens dense enough to comment from.
- Nothing is cached: every branch, commit and diff is read from git when shown.
- Runs with no account, no server and no telemetry. State lives in one SQLite file on the machine.
- Ships an MCP server over stdio, so agents such as Claude Code and Codex can read the same reviews, leave threaded comments and reply to yours. Every agent comment is attributed to the agent that wrote it.
- Reaches your other machines over ssh, wsl.exe or your own tailnet, and installs itself onto them. Nothing is relayed or stored anywhere but the computers you own.
- Installs into a coding agent as a plugin, which carries that MCP server plus a note that teaches the agent when to open a review and how to answer the comments left on it, a `/gitwarren` command, and a reviewer agent that leaves its findings as line comments.

## Installing

- Desktop app: download from https://gitwarren.com, or on macOS `brew install --cask klarluft/tap/gitwarren`. Linux ships as an AppImage.
- Command line, macOS and Linux, brings its own Node: `brew install klarluft/tap/gitwarren-cli` or `curl -fsSL https://gitwarren.com/install.sh | sh`.
- Command line anywhere Node 22.14+ is, including Windows: `npx gitwarren serve`.

## Installing it into a coding agent

The plugin is the shortest way in, and it is not an alternative to the app: it connects an agent to the reviews, while the app or the command line is where a person reads them. With one already running on the machine, the plugin uses it and its links open there; on its own, it fetches the published package and serves the review page on loopback for as long as the agent runs.

- Claude Code: `/plugin marketplace add klarluft/gitwarren-app`, then `/plugin install gitwarren@gitwarren`
- Gemini CLI: `gemini extensions install https://github.com/klarluft/gitwarren-app`
- Codex, Cursor, VS Code and Kiro: add the same repository from the tool's own plugin screen.
- Any agent, the guidance note on its own: `npx skills add klarluft/gitwarren-app`
- The MCP server by itself, without the note: `npx -y gitwarren mcp --serve`. It is listed in the MCP registry as `io.github.klarluft/gitwarren`.

## The command line

- `gitwarren serve --open` runs GitWarren in the terminal, serving on 127.0.0.1 behind a per-launch token, and opens the browser. Ctrl-C stops it.
- `gitwarren service install` keeps it running in the background, from now and at every login; `gitwarren service uninstall` undoes that.
- `gitwarren agent-setup` prints the sentence to give a coding agent so it can reach GitWarren over MCP. The MCP server reads the same SQLite file, so it works whether or not GitWarren is being served.
- `gitwarren update` moves an install made by `install.sh` (or by GitWarren over ssh) to the newest release, checking the download against the sha256 the release published, restarting the background daemon and deleting the version it replaced. A Homebrew, npm or npx copy belongs to its package manager, and the command names the right one instead. `gitwarren update --check` only says whether there is a newer release; nothing ever checks in the background.
- `gitwarren uninstall` removes GitWarren from the machine: the login item, the launchers in `~/.gitwarren/bin` that name this install, and the install itself when GitWarren put it there. It asks first, and reviews are kept unless `--data` is given. A launcher belonging to another GitWarren, such as the desktop app, is named and left alone.
- `gitwarren doctor` checks that every path GitWarren hands another program still points at something, and exits non-zero when one does not; `--fix` repoints a stale launcher and never deletes anything.

## Who it is for

Developers who run coding agents locally and want to read the agent's diff before pushing it to GitHub, GitLab or anywhere else.