What Is Codiff?
Codiff is a beautiful, minimal, local diff viewer from nkzw-tech for reviewing staged and unstaged Git changes before committing, and Codiff is one of the best Git Diff Reviewers tools for developers who want a native review flow with 11 built-in command-bar actions. It runs on a repository path or commit SHA, adds LLM walkthroughs with codiff -w, and keeps review comments local so solo engineers and platform teams can inspect diffs without opening a PR.
Quick Overview
| Attribute | Details |
|---|---|
| Type | Git Diff Reviewers |
| Best For | Developers reviewing staged and unstaged Git changes locally |
| Language/Stack | Electron desktop app, Git, Codex CLI, JSONC config |
| License | N/A |
| GitHub Stars | N/A as of Feb 2026 |
| Pricing | Open-Source |
| Last Release | N/A |
Who Should Use Codiff?
Codiff is a fit when you want to review code locally with the same focus you would bring to a formal pull request. It is optimized for fast inspection of staged changes, commit diffs, and line-level comments without needing a browser or a remote review system.
- Solo indie hackers shipping small features who want a pre-commit sanity check with fast navigation and inline notes.
- Senior engineers reviewing large diffs across many files who need a file tree, history view, and keyboard-first search.
- Teams using Codex that want an LLM-generated walkthrough order before they read the whole patch.
- Engineers who prefer native apps and want a local window per repository instead of a tab-heavy web workflow.
Not ideal for:
- Teams that need GitHub, GitLab, or Bitbucket PR comments as the primary review surface.
- Users who want a browser-first workflow with shared review state across a remote team.
- Environments where installing a desktop app or configuring a local terminal helper is not allowed.
Key Features of Codiff
- Staged and unstaged diff review — Codiff reads both the index and the working tree, so you can inspect exactly what will land in the next commit versus what is still untracked in your shell session. That makes it useful for pre-commit validation and for cleaning up partially staged changes.
- Commit-level inspection — You can pass a commit hash like
codiff a1b2c3dto review historical changes without switching to another Git UI. This is useful for code archaeology, bisecting regressions, and checking the shape of a patch before cherry-picking it. - Codex walkthrough mode —
codiff -wasks the local Codex CLI for a recommended review order and more context. The app looks forcodexonPATH,/opt/homebrew/bin/codex, and/usr/local/bin/codex, which keeps the AI flow local instead of depending on a web API wrapper. - Inline review comments — You can comment directly on changed lines and copy all review comments as Markdown for follow-up tasks. That is a useful bridge between local review and issue tracking because the output is already in a format that can be pasted into tickets or pull requests.
- Command-bar driven navigation — The command bar exposes actions for file filtering, diff search, file tree toggling, history, walkthroughs, comment export, sidebar toggling, and window reload. Keyboard shortcuts use
Modabstractions, so the same keymap model works on macOS and other platforms. - JSONC configuration with schema completion — Codiff stores settings in
~/.codiff/codiff.jsonc, supports comments and trailing commas, and ships a JSON schema reference for editor completion. The config file is watched while the app runs, so changes apply to open windows without a restart. - Multi-repository native windows — Launching Codiff in multiple repositories opens a separate native window for each repo. That is a practical choice for engineers juggling several branches or monorepo checkouts at once.
Codiff vs Alternatives
| Tool | Best For | Key Differentiator | Pricing |
|---|---|---|---|
| Codiff | Local Git diff review with inline comments and Codex walkthroughs | Native app focused on staged, unstaged, and commit-based review | Open-Source |
| GitHub Desktop | Basic Git operations and repository management | Broader repository UI, weaker review-first workflow | Free |
| VS Code Source Control | Developers already living inside VS Code | Diff review inside the editor, no dedicated review window | Free |
| Ghist | Git history browsing | History-centric interface rather than review-first commenting | Open-Source |
Pick Codiff when the goal is to review a patch before committing and you want comments, walkthroughs, and keyboard navigation in one local window. Pick GitHub Desktop when the main job is cloning, branching, and pushing rather than close reading of changed lines.
Choose VS Code Source Control if your review flow is already embedded in the editor and you do not want a separate desktop app. Choose Ghist when the real task is understanding commit history and file evolution, not writing review notes. For AI-assisted editing and prompt-driven workflows, Codiff pairs well with Claude Code Canvas, while the review surface stays in Codiff.
How Codiff Works
Codiff is a local Electron-style desktop app that builds its view directly from Git repository state. It separates the index from the working tree, which is why it can show staged and unstaged changes with the same interaction model, and it can also open a specific commit when you pass a SHA on the command line.
The UI centers on a native window with a file tree, diff panes, command bar, and optional walkthrough order. The config layer is intentionally simple: a JSONC file at ~/.codiff/codiff.jsonc defines settings like theme, whitespace rendering, AI model selection, and key bindings, while a JSON schema gives editor tooling enough structure to autocomplete and validate options.
codiff /path/to/repository
codiff a1b2c3d
codiff -w
CODIFF_CODEX_PATH=/absolute/path/to/codex codiff -w
The first command opens the current repository, the second opens a historical commit, and the third asks Codiff to generate an LLM-guided review order. The last line is the escape hatch when Codex is installed outside the usual search paths, which matters because Codiff does not source your shell startup files to discover binaries.
Pros and Cons of Codiff
Pros:
- Fast local inspection — Codiff opens directly on a repository path or commit hash, so there is no remote sync step before you can review the patch.
- Inline comments with Markdown export — Review notes stay attached to changed lines and can be copied out as Markdown for follow-up work.
- Codex-assisted walkthroughs —
codiff -wgives you an AI-generated review order instead of forcing you to read the patch file by file. - Keyboard-first navigation — The command bar and shortcut map reduce mouse use during repetitive review sessions.
- Live-reloaded config — Changes to
codiff.jsoncapply while the app is running, which makes keymap and theme tuning cheap. - Multi-repo support — Separate windows per repository keep parallel reviews from colliding in one cramped workspace.
Cons:
- Desktop-app dependency — Codiff is not a browser-based review system, so it is a poor fit for teams that only want web workflows.
- Codex CLI requirement for walkthroughs —
codiff -wdepends on a local Codex installation and PATH discovery, which adds setup friction. - No remote collaboration layer — The page describes local review and comment export, not shared PR threads or hosted approvals.
- macOS-first installation path — The documented install flow centers on Homebrew cask and the app menu, so other platforms are less explicit from the page text.
Getting Started with Codiff
brew install --cask nkzw-tech/tap/codiff
codiff /path/to/repository
codiff -w
After the first launch, open Codiff > Install Terminal Helper so the codiff command is available in your shell. If you plan to use walkthrough mode, verify codex --version first, then set CODIFF_CODEX_PATH only if Codex is installed somewhere unusual.
Verdict
Codiff is the strongest option for local Git diff review when you want a native app with optional Codex-assisted walkthroughs. Its biggest strength is fast, keyboard-driven inspection with inline comments; the main caveat is that it is a local review tool, not a hosted PR system. Use it if you want disciplined pre-commit review.



