wiff CLI
Terminal diff review tool: comments live locally and a human in the TUI and an agent via the CLI share one session
- 125 ★ on the repository
- Last commit
- Apache-2.0
Extended access
Why this level
- Reads the diff and repository history and, on GitHub, publishes comments in your name.
Install
- Works in
Manual install
curl -fsSL https://github.com/wez/wiff/releases/download/continuous/install.sh | shThe first command of the Install section. The script checks SHA-256 and installs `wiff` into `~/.local/bin`.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Reads the diff and repository history and, on GitHub, publishes comments in your name.
This is third-party code. Review the repository files before installing.
What it does
wiff captures a diff, shows it in a TUI with syntax highlighting and stores the review (comments, replies, verdicts) as a local session on disk. A human in the interface and an agent through `wiff` commands read and extend the same session at once. There are three review types. Local review covers the working tree, the index, a branch or a revision range. Forge review mirrors a GitHub pull request into a local session (`wiff forge pull 6185` or by full URL even without a checkout) and later publishes comments and the verdict back. Explore mode annotates existing code with no change. The command `wiff skill-path` expands the bundled skill into the data directory and prints the path to its `SKILL.md`.
Who it is for. Developers who review changes in a terminal and want to hand part of the review to an agent inside one session.
Good fit when
- A diff before commit needs a private review and comments without sending code to outside services.
- An agent should read your comments and answer them in the same session.
- A GitHub pull request should be read and annotated in a terminal.
- Existing files are annotated through explore mode before a new task.
Not a fit when
- You work on Windows: there are no prebuilt binaries for it.
- You need a web-based team review.
- Viewing a diff without notes or sessions is enough.
Example request
Open a wiff review of my changes, read my comments and reply to each in the session.Limitations
Prebuilt binaries exist for Linux and macOS (x86_64 and arm64), and Windows is not supported yet. Installing through `curl | sh` is not ideal for trust, so the author publishes SHA-256 sums and Sigstore attestations, verified with `gh attestation verify`. Alternative: `cargo install --git https://github.com/wez/wiff.git wiff` with Rust installed. Builds update on every commit to `main` as the `continuous` release. GitHub work uses the forge integration and needs pull request access.
How to disable. Remove the `wiff` binary from `~/.local/bin` (or the directory from `WIFF_BIN_DIR`) and session data from the data directory. Remove the skill from the agent's skills directory.
FAQ
How do I install wiff?
Run `curl -fsSL https://github.com/wez/wiff/releases/download/continuous/install.sh | sh`. The script checks SHA-256 and places the binary in `~/.local/bin`.
How do I connect an agent?
`wiff skill-path` expands the skill and prints the path to `SKILL.md`. The agent works with the session only through the CLI.
Is a network needed for review?
Local review works offline and keeps the session on your disk. The network is needed only for forge mode.
How do I verify the downloaded archive?
Each archive carries a Sigstore attestation: `gh attestation verify wiff-<target>.tar.gz --repo wez/wiff`.
Can a pull request be reviewed without a clone?
Yes. `wiff forge pull <URL>` accepts a full pull request URL from anywhere.
Discussion
No questions or reviews yet.
Related
CLI toolsA CLI that opens a local git diff in the browser like GitHub's Files changed tab; comments copy out as prompts for an agent
A CLI that opens a git diff in the browser for keyboard review and hands comments to an agent as a prompt or to GitHub.
The tuicr skill links an agent to terminal code review: it reads the human's comments and opens the review pane.
A CLI opens diffs and documents in a terminal so a person can annotate lines and pass feedback to a coding agent
A terminal diff viewer: all files in one stream, and an agent with the hunk-review skill walks through the changes and leaves line comments
A terminal UI that shows everything differing from the base branch as a pull request and sends selected code to an AI agent.
README in short
A Rust project under Apache-2.0 with documentation at wezfurlong.org/wiff. The review session acts as shared state for a human and an agent.