Skip to content
fdarianPublic

About

Local and fast code review with tracked changes and agent-narrated walkthroughs

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

nisi

A simpler way to review code.

CleanShot 2026-08-09 at 18 46 53@2x

What’s unique about nisi:

  • Re-review only what changed since you last looked. — Every other tool resets 400 lines of a reviewed file when you only added one nit. nisi snapshots your review and diffs from there.
    CleanShot.2026-08-09.at.18.44.52.mp4
  • [Soon] Generated walkthrough — Understand changes, not files. Walkthrough will group related changes (per-hunks not just file) so the diff arrives explained and in reading order, every claim linked to the lines it's about.

    This feature is still unstable, you can enable it in the settings

    CleanShot.2026-08-09.at.18.42.14.mp4

With the essentials:

  • Open with CLI — Run `nisi` anywhere in your repo to **review PR or compare diffs
    CleanShot.2026-08-09.at.18.24.47.mp4
  • Fast, and fully local — Built with Electron, gh, and SQLite

  • [Soon] Bring your own harness — Use your existing agents and subscription

More on features section

A bit about the motivation

As AI generate code faster, and (arguably) better, the bottleneck is on us to review. I believe we should still understand the code, because our subconscious (taste, vision) is what distinguishes humans with AI and one person to another. Just like we don’t need to write machine-level code (python is much simpler than assembly), we need to lift the abstraction so we see code in a different perspective that’s simpler.

I made this app because I wanted to have the feature in my own direction, because some apps have its own limitation and its own use. nisi will always be local, handy, and interoperable.

Install

Apple Silicon only, for now — the release build is arm64.

  1. Install with homebrew

    brew install --cask fdarian/tap/nisi
  2. Make sure gh CLI is installed and authenticated Check their site for the installation, and authenticate with (gh auth login). nisi shells out to gh to find the PR for your branch, and opening one fails without it.

Usage

The recommended way to use nisi is to use the CLI:

nisi
# Opens the current branch's PR in the app. No open PR? Diffs against the
# repo's default branch instead.

nisi /path/to/other/repo
# Point at a different repo without cd-ing there first.

You can also open a PR from app directly, you’ll be prompted for the folder where the branch will be cloned (it can reuse existing checkout).

Configuration

nisi keeps its data (the review database and logs) in ~/Library/Application Support/com.nisi.desktop. To keep it somewhere else, create ~/.config/nisi/config.toml:

data_dir = "~/Documents/nisi"

data_dir must be an absolute path or start with ~/. A misspelled key or an invalid value is reported as an error instead of silently falling back to the default. The NISI_DATA_DIR environment variable, when set, takes precedence.

Features

  • Handy, vim-like, keymaps:

    • j/k to navigate between files; r to mark reviewed, u to undo last reviewed
      CleanShot.2026-08-09.at.18.25.35.mp4
    • ⌘+[ / ⌘+] to go back/forward through your file focus history, browser-style

    • / to search keyword and ⌘+f for files. n/N to focus on the next/previous match
      CleanShot.2026-08-09.at.18.26.26.mp4
  • Include uncommitted changes, see new diffs in real-time
    CleanShot.2026-08-09.at.18.37.20.mp4

Acknowledgements

License

Apache-2.0

About

Local and fast code review with tracked changes and agent-narrated walkthroughs

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages