Configuration

Configure rvue analysis parameters, exclusions, and behavior through the config file, dashboard settings, or environment variables.

Configuration file

When you run rvue enable, a configuration file is created at .rvue/config.json. This file is committed to your repository and controls how analysis behaves.

.rvue/config.json

{
  "version": "1.0.0",
  "analysis": {
    "lookback_months": 12,
    "min_prs_for_pattern": 10,
    "min_confidence": 0.7,
    "include_closed_prs": true
  },
  "ignore": {
    "files": [],
    "authors": ["dependabot[bot]", "renovate[bot]"],
    "labels": ["wip", "draft"]
  },
  "sync": {
    "auto_commit": false
  },
  "custom_rules": []
}

Analysis settings

Setting	Type	Default	Description
lookback_months	number	12	How many months of PR history to analyze. Longer lookback means more data but slower analysis.
min_prs_for_pattern	number	10	Minimum number of PRs required before a convention is reported. Prevents premature pattern detection.
min_confidence	number	0.7	Minimum confidence score (0.0–1.0) for a convention to be included. Lower values include more uncertain patterns.
include_closed_prs	boolean	true	Whether to analyze closed (not merged) PRs. Useful for anti-pattern detection from rejected PRs.

ℹDashboard vs config file

Settings can be modified in both the .rvue/config.json file and the web dashboard settings page. The dashboard settings are stored server-side and used when the cloud pipeline runs. The local config file is used by CLI commands like rvue check.

Exclusions

File patterns

Specify file patterns to exclude from analysis. These files won't be scanned and won't affect convention detection.

Default ignored patterns

node_modules/
dist/
.next/
coverage/
*.min.js

In the dashboard settings, enter one pattern per line. In the config file, use the ignore.files array.

Ignored authors

PR comments from these authors are excluded from analysis. This prevents bot-generated content from affecting pattern detection.

Default ignored authors

dependabot[bot]
renovate[bot]

Ignored labels

PRs with these labels are excluded from analysis. Useful for filtering out work-in-progress or draft PRs.

Default ignored labels

wip
draft

Dashboard settings

The web dashboard provides a settings page for each repository at /repo/[id]/settings. These settings are persisted server-side and used during cloud analysis.

Setting	Default	Description
Auto-sync on PR merge	Off	Enable automatic intelligence updates via GitHub Action
Include closed PRs	On	Analyze closed (not merged) PRs for anti-pattern detection
Lookback period	12 months	PR history lookback window
Minimum confidence	70%	Convention filtering threshold
Min PRs for pattern	10	Minimum evidence before reporting
Domain knowledge extraction	On	Build knowledge graph from PR discussions
Reviewer expertise tracking	On	Map reviewers to expertise areas
Ignored file patterns	node_modules/, dist/, ...	Files excluded from codebase scanning
Ignored authors	dependabot[bot], renovate[bot]	Authors excluded from PR analysis

Environment variables

Variable	Description
RVUE_TOKEN	API token for CI/CD authentication. Takes precedence over stored CLI credentials.
GITHUB_TOKEN	GitHub personal access token for PR fetching. Required in CI for private repos.
RVUE_API_URL	Override the rvue API base URL. Default: https://rvue.dev. Useful for self-hosted or development.
RVUE_TELEMETRY_DISABLED	Set to 1 to disable anonymous usage telemetry.
DO_NOT_TRACK	Standard opt-out for telemetry. Set to 1 to disable.

Telemetry

rvue collects anonymous usage telemetry via PostHog to understand how the CLI is used and improve the product. No source code or intelligence content is ever collected. Telemetry events include:

Command usage (which commands are run)
Success/failure counts
Convention and PR counts (numeric only)
Platform, OS, and Node.js version

To opt out, set RVUE_TELEMETRY_DISABLED=1 or DO_NOT_TRACK=1 in your environment.

Plans and limits

Feature	Free	Team
Public repositories	Unlimited	Unlimited
Private repositories	1	Unlimited
PR lookback	100 PRs	Unlimited
AI model	DeepSeek v3.2	Claude Sonnet
Team management	-	Included
Usage analytics	Basic	Full