PR Review Command

The aetheris pr command analyzes GitHub Pull Requests with AI and posts review comments.

Prerequisites

GitHub CLI

GitHub CLI must be installed and authenticated:

# Install
brew install gh        # macOS
sudo apt install gh    # Ubuntu/Debian
winget install gh      # Windows

# Authenticate
gh auth login

Required GitHub Permissions

The aetheris pr command requires the following minimum permission scopes:

When running gh auth login, select HTTPS as the protocol and authenticate via browser. The default scopes granted by gh auth login are sufficient for most use cases.

To verify your current scopes:

gh auth status

Tip: If you only need to review public repositories, the public_repo scope (subset of repo) is sufficient.

AI Provider Configuration

Configure at least one AI provider by setting the appropriate environment variable in your .env file or shell:

Example .env file:

# Choose one or more providers
AI_PROVIDER=gemini                    # Default provider (gemini, openai, or claude)
GEMINI_API_KEY=your-gemini-key-here
OPENAI_API_KEY=your-openai-key-here   # Optional: for multi-provider reviews
ANTHROPIC_API_KEY=your-claude-key     # Optional: for multi-provider reviews

Tip: For multi-provider consensus reviews (--providers gemini,claude,openai), configure all providers you intend to use.

Usage

aetheris pr [options]

Options

PR Identification (mutually exclusive)

You must specify the PR using one of these methods:

Note: --url and --repo/--pr are mutually exclusive. Use either --url alone, or --repo together with --pr. Providing both will result in an error.

Analysis Options

Note: When --auto-fix is combined with --dry-run, the analysis runs in simulation mode: issues are identified and fixes are proposed but not applied. No comments are posted and no code is modified. This is useful for previewing what fixes would be suggested before running the actual auto-fix.

Examples

Analyze by URL

aetheris pr --url https://github.com/owner/repo/pull/123

Analyze by Repo and Number

aetheris pr --repo owner/repo --pr 123

Multi-Provider Consensus

aetheris pr --url https://... --providers gemini,claude

All Three Providers

aetheris pr --url https://... --providers gemini,claude,openai

Disable Consensus

aetheris pr --url https://... --providers gemini,claude --no-consensus

Dry Run

aetheris pr --url https://... --dry-run

Filter by Severity

aetheris pr --url https://... --severity high

Save Report

aetheris pr --url https://... --output review.md

Preview Auto-Fix (Dry Run)

aetheris pr --url https://... --auto-fix --dry-run

Consensus Mode

When using multiple providers, consensus mode (default): - Only reports issues found by ALL providers - Reduces false positives - Higher confidence in results

Issue Types

Severity Levels