servediff

Review local Git changes in your browser without modifying your working tree or index.

Install

With Homebrew:

brew install flexdinesh/tap/servediff

With Go 1.25 or later:

go install github.com/flexdinesh/servediff/cmd/servediff@latest

Usage

Run from a Git repository:

servediff .

You can also serve another repository or choose the address:

servediff /path/to/repo
servediff . --port 4000
servediff . --host 0.0.0.0
servediff --version

By default, servediff binds to 127.0.0.1, opens a browser, and uses the first available port from 7981 through 7990. Stop it with Ctrl+C.

Passing --host 0.0.0.0 exposes the unauthenticated server on every network interface and accepts any HTTP host name. Use it only on a trusted network.

Reviewing changes

Switch between all, staged, and unstaged changes. Use the file tree to navigate, mark files as reviewed, and select + beside a line to comment. Copy unresolved and Copy all export review comments as agent-ready XML.

Comments and reviewed-file marks persist by repository. Display preferences stay in the browser.

Piped diffs

Serve a fixed Git patch instead of a live repository:

git diff | servediff
git show | servediff
git show main..HEAD~1 | servediff
servediff - < saved.patch

Piped input takes priority over a directory argument. Re-run the command to refresh a piped diff. Standard Git patches are limited to 16 MiB total and 2 MiB per file. Combined merge diffs are shown against the first parent. Use git show --diff-merges=separate to review the result against every parent.

API and data

The OpenAPI 3.1 contract is served at /openapi.yaml; REST endpoints are under /api/v1. Compatible coding agents can access review-comment tools through the MCP 2026-07-28 Streamable HTTP endpoint at /mcp; see docs/mcp.md.

A compatible browser can expose the same tools to its browser agent through WebMCP while the servediff page is open; see docs/webmcp.md.

The API is unauthenticated. Browser same-origin and cross-site checks remain, but anyone who can reach the server can access its review data.

Review data is stored under $XDG_STATE_HOME/servediff/reviews, or ~/.local/state/servediff/reviews when XDG_STATE_HOME is unset.

For source setup, development commands, and architecture, see docs/development.md. Maintainers can find publishing instructions in docs/release.md.