Skip to main content
Configure your account, PR reviews, and integrations from the Settings page.

​
Account

  • Name: Editable display name
  • Email: Synced from GitHub (read-only)
  • Avatar: Synced from GitHub profile

​
Automatic PR Reviews

Toggle automatic PR scanning on/off and manage monitored repositories:
  1. Enable the “Automatic PR Reviews” toggle
  2. Click “Add Repos” to select repositories
  3. Search and select repositories with checkboxes
  4. Monitored repos appear in the list below
  5. Remove repos using the X button
Disabling PR reviews will remove all monitored repositories.

​
Review Options

Configure what to include in automatic PR reviews:
Find issues beyond the changed lines. When enabled, Paragon analyzes surrounding code context to catch issues that may be affected by your changes but aren’t in the diff itself.Example: You modify a function’s return type. Paragon flags callers of that function elsewhere in the file that may now have type mismatches.
One-click commit fixes directly from the PR. Paragon provides actionable code suggestions that you can apply instantly without leaving GitHub.Example: Paragon detects a missing null check and offers a “Commit suggestion” button that adds if (user == null) return; with a single click.
Show inline diffs for suggestions. Instead of just describing the fix, Paragon displays a visual before/after diff so you can see exactly what changes are proposed.Example:
- const data = response.data
+ const data = response.data ?? []
Generate an overview of review findings at the top of the PR. Provides a high-level summary including issue counts by severity, key concerns, and overall assessment.Example: “This PR adds user authentication. Found 2 high-severity issues (SQL injection risk, missing rate limiting) and 3 medium-severity suggestions.”
Split the PR summary and detailed review into 2 separate comments. Useful for large PRs where you want the overview separate from line-by-line feedback.Example: First comment contains the executive summary and issue counts. Second comment contains all inline code review comments.
Review draft pull requests. When enabled, Paragon runs automatic reviews on PRs marked as drafts, giving you early feedback before the PR is ready for human review.Example: You open a draft PR for a new feature. Paragon immediately reviews it and catches a security issue before you’ve even requested review from teammates.
Generate an architecture flow diagram showing how the changed code fits into the system. Visualizes data flow, component relationships, and integration points.Example: For a PR modifying an API endpoint, Paragon generates a Mermaid diagram showing: Client → API Gateway → Auth Middleware → Your Endpoint → Database.

​
GitHub Connection

Connect your GitHub account to enable repository access:
  • View connection status in “Code Host Connections”
  • Click “Connect” or “Reconnect” to authorize
  • Tokens are encrypted and auto-refresh

​
API Key

Your API key is displayed in Settings. Use it for CLI authentication with paragon auth login.

​
Severity Filters

Control which types of issues are reported in your PR reviews.

​
Issue Severity Levels

Critical

Security vulnerabilities, data loss risks, crash-causing bugs

High

Major bugs, significant performance issues

Medium

Code quality issues, best practice violations

Low

Style issues, minor improvements, suggestions

​
Additional Filters

FilterDescription
Out of DiffInclude issues found outside the changed lines
PR SummaryGenerate a summary of analysis findings
System DiagramGenerate architecture visualization (requires PR Summary)
At least one severity filter must remain enabled.

​
Custom Rules

Define custom coding standards for the AI to follow during code reviews.

​
Upload Documents

Upload existing documentation to automatically extract rules:
  • Supported formats: PDF, DOCX, MD, TXT
  • AI extracts coding rules automatically
  • Rules tagged with “upload” source

​
Manual Entry

Add rules by typing directly:
  1. Click “Manual Entry”
  2. Type your rule or guideline
  3. Save to add to active rules

​
Example Rules

All API endpoints must include error handling with try-catch
Use TypeScript strict mode for all new files
Database queries must use parameterized statements

​
Managing Rules

  • Click any rule to view full content
  • Copy rule content to clipboard
  • Delete rules no longer needed
  • View source (upload/manual) and creation date