Installation

1
Download the installer

Grab the latest installer for your platform from the Releases page:

  • macOS — Reviewly_<version>_universal.dmg (Apple Silicon + Intel, signed & notarized)
  • Windows — Reviewly_<version>_x64-setup.exe or .msi
  • Linux — .AppImage, .deb, or .rpm
2
Connect your GitHub account

On first launch, Reviewly walks you through a short setup: connect your GitHub account with a device code you approve in the browser (GitHub's OAuth Device Flow), then pick the repositories you want to watch.

Your token is stored in the OS keychain — Keychain on macOS, Credential Manager on Windows, Secret Service on Linux — never written to disk in plaintext.

3
Turn on AI review (optional)

Reviewly is a complete review client without AI. If you want the guided tour, layered review, or Ask AI chat, open Settings → AI review and pick a provider:

  • Already have an AI CLI? Select Claude, Codex, or Gemini — Reviewly detects whether the binary is on your PATH and signed in. For Claude, install Claude Code and run claude once to log in.
  • Prefer your own endpoint? Choose OpenAI-compatible and enter a base URL, model, and optional API key — point it at OpenAI, a local Ollama or LM Studio server, OpenRouter, or anything that speaks the OpenAI API.

Add custom review instructions in the same panel to bake your team's review standards into every tour and chat.

4
Stay up to date

Reviewly checks for updates silently on launch and offers a one-click "Restart & install" — no manual downloads after the first install.

Building from source#

Prefer to build it yourself? You'll need Bun ≥ 1.3, Rust (stable), and the platform toolchain for Tauri (Xcode Command Line Tools on macOS, the Tauri Linux deps, or the MSVC build tools on Windows).

bun install
bun run tauri dev       # launch the desktop app with hot reload

Other useful scripts: bun run typecheck, bun run lint, bun run build (front end only), and bun run tauri build (produces installers in src-tauri/target/release/bundle).

The GitHub OAuth client ID ships in the repo and is public, so the app builds and signs in out of the box. To use your own OAuth app instead, register one with Device Flow enabled and the repo, read:user, notifications, and workflow scopes.

Updated

Was this page helpful?