Diffreview – code review for local Claude diffs

A native macOS tool called diffreview has been released to let developers review local git diffs GitHub-PR style and print the resulting comments to stdout as markdown for Claude Code or any other markdown-reading tool. Running `diffreview` in a git repository opens a window showing uncommitted changes (`git diff HEAD` plus untracked files), while `diffreview --base main` compares committed work only over `merge-base..HEAD`; submitting a review exits with code 0, closing without submitting exits 1, and bad arguments or a non-git directory exit 2. Drafts autosave to `.git/diffreview/comments.json`, and the repo ships a `/diffreview` Claude Code command that aborts if the review is cancelled, with the README warning that Claude Code's 2-minute Bash timeout must be raised via `BASH_DEFAULT_TIMEOUT_MS` and `BASH_MAX_TIMEOUT_MS` in `~/.claude/settings.json` for longer reviews.

A native macOS tool for reviewing local code changes GitHub-PR style, built to send that review back to Claude Code https://claude.com/claude-code or anything else that reads markdown . Run diffreview in a git repository and a window opens with the diff. Leave inline comments on lines or ranges, file-level comments and an overall summary, then click Submit review . The review is printed to stdout as markdown and the process exits. - macOS 14 or later - Swift 6 toolchain Xcode or the Command Line Tools - git on your PATH git clone <this repo diffreview && cd diffreview swift build -c release install -m 755 .build/release/diffreview ~/.local/bin/diffreview or any directory on your PATH diffreview uncommitted changes: git diff HEAD plus untracked files diffreview --base main commits on the current branch since its merge-base with main diffreview --help | Result | stdout | exit code | |---|---|---| | Submit review | the review as markdown | 0 | | Close window / quit without submitting | nothing | 1 | | No changes to review | nothing message on stderr | 1 | | Not a git repository, unknown ref, bad arguments | nothing message on stderr | 2 | --base compares committed work only merge-base..HEAD , like a pull request. Uncommitted changes are not included in that mode. - Click a line to comment on it. Shift-click another line in the same file to extend the comment to a range. - ⌘↩ adds the comment, Esc cancels. Existing comments can be edited or deleted. - Comment on file in each file header adds a file-level comment. - Finish review ⌘⇧↩ opens the summary box and the Submit review button. - Files can be collapsed. Files with more than 1,500 changed lines start collapsed. Drafts are saved automatically to .git/diffreview/comments.json , so closing the window doesn't lose work: the next run picks up where you left off. The file is deleted when you submit. If you close the window while a comment is still being typed, that text is kept as a comment. Code Review Overall summary. path/to/file.swift A file-level comment. Lines 42-45 new swift let the = "selected lines" The comment. Line numbers refer to the new version of the file, or to the old version old when only deleted lines are selected. Selections that mix added and removed lines are shown as a diff block. The repo ships a /diffreview command in .claude/commands/diffreview.md https://github.com/chalmagean/diffreview/blob/main/.claude/commands/diffreview.md . Install it for all your projects: mkdir -p ~/.claude/commands cp .claude/commands/diffreview.md ~/.claude/commands/ It contains: --- description: Open diffreview to review changes GitHub-style, then address the comments argument-hint: --base <ref allowed-tools: Bash diffreview Bash diffreview --- diffreview $ARGUMENTS Address each review comment above. If something is unclear, ask before changing it. Then run /diffreview or /diffreview --base main in any repository. Cancelling the review makes the command abort, so nothing is sent to Claude. Timeout: Claude Code runs commands under the Bash tool's default timeout of 2 minutes, and reviews usually take longer. Raise it in ~/.claude/settings.json : { "env": { "BASH DEFAULT TIMEOUT MS": "3600000", "BASH MAX TIMEOUT MS": "3600000" } } This also changes the default timeout for every other Bash command Claude Code runs. swift build scripts/test.sh Use scripts/test.sh rather than swift test . With only the Command Line Tools installed no Xcode , swift test builds the swift-testing tests but runs none of them and still reports success. The script detects that setup and runs the tests through a small runner scripts/TestRunner.swift . Under Xcode it just calls swift test . - Sources/DiffReviewCore : no UI. Runs git, parses unified diffs renames, copies, binary files, mode changes, quoted paths, "\ No newline at end of file" , models comments, renders the markdown review and stores drafts. - Sources/diffreview : the AppKit/SwiftUI app. - Tests/DiffReviewCoreTests : parser and renderer tests, plus integration tests that run real git in temporary repositories. Syntax highlighting isn't implemented yet. Sources/diffreview/SyntaxHighlighter.swift is the place to add it: each line is passed through SyntaxHighlighter.highlight :language: .