reviewer

KO | EN

gitlite — search

#react #swift #tailwindcss #computer-vision #terminal #svg #awesome-list #nextjs #graphql #data-science

(★ 9)

UI for agent-generated code reviews

File Explorer

ZIP Download

- - ci.yml
  - release.yml
- extensions.json
- launch.json
- screenshot.png
- entitlements.mac.plist
- icon.icns
- icon.ico
- icon.png
- icon.svg
- - check.ts
  - diff.ts
  - emit.ts
  - open.ts
  - schema.ts
  - skills.ts
- agent-header.test.ts
- agent-header.ts
- app.test.ts
- app.ts
- bundle.setup.ts
- context.test.ts
- context.ts
- coverage-report.ts
- emit.test.ts
- errors.ts
- exit-gate.test.ts
- fixtures.ts
- git.test.ts
- git.ts
- index.test.ts
- index.ts
- install-cli.test.ts
- launch.test.ts
- launch.ts
- live-range.test.ts
- portability.test.ts
- range.ts
- skills.test.ts
- skills.ts
- stdout.test.ts
- version.ts
- contrast-report.json
- design-manifest.json
- globals.css
- preview.html
- README.md
- tokens.json
- check-package.mjs
- gen-icon.mjs
- install-cli.sh
- pack-cli.mjs
- reset-state.mjs
- - SKILL.md
- - cli-install.test.ts
  - cli-install.ts
  - crash.test.ts
  - crash.ts
  - env.d.ts
  - external-links.test.ts
  - external-links.ts
  - index.ts
  - ipc-registry.test.ts
  - ipc-registry.ts
  - ipc.ts
  - menu.ts
  - onboarding.ts
  - sessions.test.ts
  - sessions.ts
  - settings.test.ts
  - settings.ts
  - shutdown.ts
  - store.ts
  - theme.test.ts
  - theme.ts
  - user-settings.ts
  - window-state.test.ts
  - window-state.ts
  - window.ts
- - index.d.ts
  - index.ts
- - index.html
- - assert.ts
  - clamp.ts
  - cli.ts
  - contracts.test.ts
  - contracts.ts
  - debounce.test.ts
  - debounce.ts
  - errors.test.ts
  - errors.ts
  - git.test.ts
  - git.ts
  - ipc-schemas.ts
  - ipc.ts
  - layers.test.ts
  - layers.ts
  - markdown.test.ts
  - markdown.ts
  - plural.ts
  - review-ipc.ts
  - review-progress.ts
  - review.test.ts
  - review.ts
  - session.test.ts
  - session.ts
  - settings.test.ts
  - settings.ts
  - themes.test.ts
  - themes.ts
- - review-coverage.test.ts
  - review-coverage.ts
  - review-emit.test.ts
  - review-emit.ts
  - review-exit-gate.test.ts
  - review-schema.test.ts
  - review-schema.ts
  - review-validator.test.ts
  - review-validator.ts
.editorconfig
.gitignore
.oxlintrc.json
.prettierignore
bun.lock
CLAUDE.md
components.json
electron-builder.yml
electron.vite.config.ts
LICENSE
package.json
README.md
tsconfig.json
tsconfig.node.json
tsconfig.shared.json
tsconfig.tools.json
tsconfig.web.json
vite.preview.config.mts
vitest.config.ts

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

A macOS app for reading code reviews written by your coding agent.

By now you have probably put real work into how your agent reviews — a review skill, house rules in
`CLAUDE.md` or `AGENTS.md`, conventions written down somewhere it can read. What comes out of all
that still lands as a wall of text in a terminal, where you scroll and rebuild the diff in your head.

![Reviewer showing a diff grouped into ordered layers with anchored review comments](https://raw.githubusercontent.com/alxnddr/reviewer/main/assets/screenshot.png)

## Two things

**Bring your own agent.** `rvw` is a small CLI that takes a finished review as JSON. It has no
opinion about what a bug is and never tells your agent what to look for. Ask for the review the way
you already do — your `/code-review`, your skills, your `CLAUDE.md` — and the findings stay yours.
Any agent that can run a shell command can hand them over.

**The CLI turns findings into a tour.** A bundled skill walks the agent through building one: a
summary of what the change does and why, the diff cut into chapters you read in order — the schema
before the code that consumes it, the fix before the tests that pin it — and each finding anchored
to the lines it's about. You read it top to bottom instead of piecing it back together.

Anchors are checked against the real diff before a review is saved, so a comment can't land on the
wrong code. Reviews are files on your disk — no account, no server.

## Use it

Prompt for the review the way you already prompt for it — your skill, your rules, your wording — and
add one clause saying where the findings go: *…then present the findings using the rvw CLI.* The
app's own start screen shows this line with that clause marked, and a button that copies just the
clause.

Below, `/code-review` is Claude Code's built-in review skill — it stands in for whatever you already
use, and only that first half changes from setup to setup:

```
/code-review this branch against main — then present the findings using the rvw CLI.
```

`rvw` tells your agent the rest — the draft format and the guidance for building the tour ship with
the CLI as a skill, so none of it has to live in your prompt. The commit range is worked out for
you, and the app opens as soon as the review is written.

Reviews land in `~/.rvw/reviews/`. The start screen — the window with no review open, and ⌘T for a
tab of it beside one — lists the recent ones newest-first; **File ▸ Recent Reviews** (⇧⌘R) searches
all of them. Reviews keep git refs rather than a copy of the diff, so the app rebuilds the change
from your branch every time you open it — which also means a review opens only where the repo is. To
send one to a machine without the checkout, `rvw emit --embed-patch` packs the diff into the file
itself. `rvw --help` has the rest.

**Settings** (⌘,, or the gear in the title bar) hold the theme and the diff's typography — code
font, size, line height, tab size, ligatures, line wrapping. Each row resets to its default on its
own, and the file behind it is `settings.json` in the app's data directory if you would rather
edit it by hand.

## Install

macOS. Download the `.dmg` from the [latest release](../../releases/latest), or build it:

```bash
bun install
bun run build:mac    # → Reviewer.app + .dmg in dist/
bun run build:cli    # → rvw CLI at dist/rvw.js
```

Builds are unsigned, so on first launch right-click → **Open**, or run:
`xattr -dr com.apple.quarantine /Applications/Reviewer.app`

**On Linux** there is no app, but `rvw` runs anywhere node ≥ 20 does, so you can write and check reviews on a Linux box and open them on a Mac. Each release attaches `rvw-<version>-any.tar.gz`, and `scripts/install-cli.sh` installs it for the current user:

```bash
curl -fsSL https://raw.githubusercontent.com/alxnddr/reviewer/main/scripts/install-cli.sh | sh
sh install-cli.sh --version 0.4.0          # one release rather than the latest
sh install-cli.sh rvw-0.4.0-any.tar.gz     # a tarball you already have (bun run pack:cli)
sh install-cli.sh --uninstall
```

It unpacks the release to `~/.local/share/rvw/<version>` and writes `~/.local/bin/rvw`, a launcher that runs it with the `node` on your PATH. Every verb works except `rvw open`, which launches the macOS app and exits 2 anywhere else. `rvw emit` still writes the artifact there but says it could not open it, so pass `--no-open`.

## Develop

```bash
bun run dev        # build the CLI bundle, then electron-vite dev (HMR)
bun run dev:fresh  # reset to a first launch, then dev
bun run check      # typecheck + lint + format
bun run test       # vitest
```

The installed `rvw` is a two-line shim that execs the app's bundle, so it follows the app — an
update to Reviewer updates the command with no reinstall. In development that bundle is
`dist/rvw.js`, which is why `bun run dev` rebuilds it first; edit anything under `cli/` mid-session
and re-run `bun run build:cli` to catch the shim up.

`bun run reset` does that reset on its own: it clears the first-run guide's flag, empties the tab
strip (backup at `sessions.json.bak`), and removes the installed `rvw` launcher. Your settings
(⌘, — theme, code font, and the rest) are left alone. `--keep-tabs` / `--keep-cli` skip a part; quit the app first, or pass `--force`.

## License

MIT — see [LICENSE](./LICENSE).

> **Note:** fully vibecoded. Every line was written by Claude and no human has read the code.

reviewer

Owner Repos

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

reviewer

Owner Repos

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README