reviewer-cli 0.1.4

Deterministic pull request review for public GitHub pull requests

Reviewer CLI

Reviewer CLI exposes the shared pull request analysis engine as a guided terminal experience.

Install

After the package is published, install it with pipx for the cleanest global command setup:

pipx install reviewer-cli

You can also install it with pip:

pip install reviewer-cli

For local development in this repository:

pip install -e backend

Configure

Preferred setup uses GitHub device login with your GitHub OAuth app client id:

# Windows PowerShell
$env:GITHUB_CLIENT_ID="your_client_id_here"

# macOS / Linux
export GITHUB_CLIENT_ID="your_client_id_here"

Advanced users can still provide a token directly:

# Windows PowerShell
$env:GITHUB_TOKEN="your_token_here"

# macOS / Linux
export GITHUB_TOKEN="your_token_here"

Optional: override where Reviewer stores the local login session.

# Windows PowerShell
$env:REVIEWER_CONFIG_DIR="C:\Users\you\AppData\Roaming\reviewer-cli"

Usage

reviewer login
reviewer whoami
reviewer analyze https://github.com/owner/repo/pull/123
reviewer publish-summary https://github.com/owner/repo/pull/123
reviewer logout

What The CLI Does For Users

• Guides GitHub login step by step with the device link and one-time code.
• Reuses the saved GitHub session automatically so people do not have to log in again on every command.
• Renders reports in readable sections so the next action is obvious.
• Suggests what to do after login, publish, and logout.

Protected commands automatically start the login flow when no valid session is available.