Getting started

ReviewArc uses the developer tools and GitHub identity already configured on your Mac.

Prerequisites

Install these command-line tools and make sure they are available in your shell:

• git for fetching pull request revisions into isolated managed caches.
• gh for GitHub authentication, repositories, pull requests, and publishing reviews.
• For agent review, either codex or claude, installed and authenticated. You can browse the inbox and open existing reviews without an AI harness.

Authenticate GitHub CLI before opening ReviewArc:

gh auth login
gh auth status

ReviewArc follows the Git operations protocol shown by gh auth status. If your GitHub CLI account uses SSH, managed Git fetches use SSH; if it uses HTTPS, ReviewArc uses HTTPS.

Choose sources

1. Open Settings and confirm Git and GitHub CLI are detected.
2. Confirm the expected GitHub account and Git operations protocol are shown.
3. Select the organizations or individual repositories you want in your inbox.
4. Return to the inbox and refresh.

No existing local checkout is required. ReviewArc does not clone a repository until you open a pull request that needs deeper inspection.

ReviewArc follows the macOS appearance by default; choose System, Light, or Dark under Settings → Appearance.

The first time you start an analysis, choose a harness, model, and reasoning level inline. ReviewArc saves that profile as the default. Later analyses are one click, with a compact per-run override; the same defaults live in the single Settings → AI Analysis section.

Open a review

Choose any pull request in the inbox. ReviewArc loads GitHub metadata, creates or updates its managed cache, checks out the exact pull request revision inside application storage, and prepares the changed files and diff for review.

The ReviewArc home page always shows the latest signed macOS build, and every published build is listed with its checksum on the releases page.