- Category
- Developer Tools
- Rank
- No. 1211Tools index
Previous survey · No. 1202 ·
- Pricing
- Open Source
- Type
- TOOL
- Use case
- Software Testing & Quality
- Interfaces
- Web
- GitHub
- 204 stars
- Latest release
- v0.5.4
- Date
About
A keyboard-first diff viewer with LSP support and GitHub integration. It lets users review a Git diff in the browser and comment on lines, blocks, or whole files.
What it does
Diffle is a single binary that starts a small local server and opens a page showing what changed in a repository: uncommitted work, a branch since it forked, one commit, a GitHub pull request, or how a commit series was reworked. You move through the changes with Vim-style keys and attach notes to a spot, a selection or a whole file. When you finish, the notes come out as one prompt you can paste into a coding agent, or go into an unsent draft on the pull request. Installed language servers add jump-to-definition, references and hover.
Why it's ranked here
It is built around one loop: read what an agent changed, then tell the agent exactly what to fix. The pieces back that up: closing the last tab prints your open notes to the terminal, notes are stored inside the repository's own Git directory so the working tree stays untouched, and notes follow their text as code moves. It ships under Apache 2.0 through Homebrew, conda-forge, npm, crates.io and Nix, with binaries for Linux, Apple silicon macOS and Windows on both x64 and arm64.
What's good
The GitHub side is careful. It adds notes to a pending review and never submits it, so you edit and send on GitHub yourself, and re-sending a note updates the existing draft comment instead of duplicating it. Generated files start collapsed using the same attribute GitHub reads. A change graph shows one box per file or per symbol, with arrows for what uses what, and can pull in unchanged callers and tests. The server rejects requests whose Host or Origin header does not match, and caps request bodies at 1 MB.
Tradeoffs
Language servers run inside the repository and can read anything your user account can; a flag turns them all off, but then the graph and the code navigation go with them. Large repositories can take a while to index. Pushing notes to GitHub only works when the comparison matches the pull request's committed changes, so unpushed commits or local edits rule it out, and stale notes are skipped. Without a GitHub token the pull request command and export are unavailable. Running it behind a reverse proxy needs the right origin flags.
How to use it well
It suits developers who hand work to coding agents and want to answer with precise, located feedback instead of a loose chat message. Run it on uncommitted changes, annotate, close the tab, and paste the printed prompt back to the agent. The project ships ready lazygit commands for this. Check which language servers it found before a session so navigation works. For human pull request review it only drafts comments; editing, dropping and submitting them still happens on GitHub.
Technical notes+
The server is a Rust 2024 workspace (Cargo.toml: rust-version 1.89, thin LTO, stripped release) in one crate whose crates/diffle/src/lib.rs exposes modules for cli, comments, git, github, graph, lsp, session, watcher and more; crates/diffle/src/main.rs just calls diffle::cli::main. crates/diffle/src/server/mod.rs builds an axum router: DEFAULT_PORT is 4966, a taken port probes up to 100 higher, a limit_body middleware drains and rejects bodies over MAX_BODY_BYTES (1 MiB) with 413, and a RequestGuard Host/Origin check guards both the API routes and the /ws upgrade with a 403 naming the failing header. crates/diffle/Cargo.toml embeds the built React client with rust-embed, talks to GitHub through octocrab over reqwest, watches files with notify, and carries cargo-binstall metadata pointing at release archives. crates/diffle/src/comments/mod.rs splits comments into anchor, relocation, import and format submodules. AGENTS.md states review state persists under the Git directory keyed by a comment key, and that pull request fetches land only in session-owned refs. package.json lists React 19, zustand and @pierre/diffs for the client; npm/package.json is a thin bin wrapper requiring Node 20 or newer.
Observed
- License
- Apache-2.0
- Language
- Rust server (axum on tokio), TypeScript and React client
- Interface
- CLI that serves a local web UI over HTTP and WebSocket
- Install surface
- Homebrew, conda-forge, npm, crates.io, Nix, shell and PowerShell install scripts
- Platform support
- Linux x64 and arm64 (glibc), Apple silicon macOS, Windows x64 and arm64
- Agent hand-off
- Notes copied or printed on exit as a single prompt
- GitHub integration
- Adds to a pending review, never submits; token from GITHUB_TOKEN, GH_TOKEN or gh
- Code navigation
- Language Server Protocol servers found on PATH, optional per run
Read from README.md, Cargo.toml, package.json, crates/diffle/Cargo.toml, crates/diffle/src/main.rs, crates/diffle/src/lib.rs, crates/diffle/src/comments/mod.rs, crates/diffle/src/server/mod.rs, AGENTS.md, LICENSE, npm/package.json.
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.