CLI Reference

# Run directly (no install)
npx rvue-cli <command>

# Or install globally
npm install -g rvue-cli
rvue <command>

enable

Enable rvue intelligence for the current repository. This is the primary setup command. It registers your repo, scans your codebase, fetches PR history, runs AI analysis, and writes intelligence files.

rvue enable [options]

What it does

1. Detects the GitHub repository from git remotes
2. Fetches repository info from GitHub (visibility, default branch)
3. Registers the repo with rvue cloud (checks plan limits)
4. Scans codebase: tech stack detection, file patterns, code patterns, config rules import, git contributor analysis, repo docs scanning
5. Fetches merged and closed PRs (up to 12 months lookback)
6. Sends data to the cloud analysis pipeline
7. Writes .rvue/intelligence.json, .rvue/config.json, and the Agent Skill

Output files

sync

Incrementally update intelligence with the latest PR data. Only fetches PRs merged since the last sync, then merges new intelligence with existing data (additive, never lossy).

rvue sync [options]

CI mode

When running in CI/CD (e.g., GitHub Actions), use --ci and set the RVUE_TOKEN and GITHUB_TOKEN environment variables:

- name: Sync rvue intelligence
  run: npx rvue-cli@latest sync --ci
  env:
    RVUE_TOKEN: ${{ secrets.RVUE_TOKEN }}
    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

check

Validate a file against your team's conventions and anti-patterns. Runs entirely locally using .rvue/intelligence.json: no network required.

rvue check <file> [options]

Checks performed

Exits with code 1 if any violations have error severity. Useful as a pre-commit hook or CI check.

Checking src/api/client.ts against team conventions...

  ✗ Catching errors without logging or re-throwing
    → Always log the error with context or re-throw

  ! Using default export - team convention prefers named exports
    → Use named exports: export function/const instead of export default

  1 error, 1 warning, 0 info

show

Display intelligence data in the terminal. Useful for reviewing what rvue has learned about your team.

rvue show <type> [options]

Types

summary: High-level overview: repo name, maturity level, counts for all intelligence categories, tech stack, last sync time.

conventions: All conventions grouped by category, with confidence scores, evidence counts, and source attribution.

anti-patterns: Detected anti-patterns sorted by severity, with explanations and correct alternatives.

knowledge: Domain knowledge graph organized by topic (authentication, database, deployment, etc.) with confidence scores.

reviewers: Reviewer expertise map showing who reviews which areas, total reviews, and approval rates.

rvue show conventions --json | jq '.[] | select(.confidence > 0.9)'

login

Authenticate with rvue using GitHub OAuth. Opens your browser for authorization, then stores credentials locally.

rvue login

The CLI uses a device code flow: it displays a verification code, opens the rvue auth page in your browser, and polls until authentication completes. Credentials are stored securely in your system config directory.

logout

Clear stored credentials from your machine.

rvue logout

whoami

Display the currently authenticated user.

rvue whoami

rvue CLI - Current User
  Login: sriram
  Email: sriram@example.com
  ID:    usr_abc123

token

Manage API tokens for CI/CD and programmatic access. Tokens use the rvue_ prefix and are stored as SHA-256 hashes on the server.

token create

rvue token create --name <name> [--scope <scope>] [--repo-id <id>]

token list

List all your API tokens with metadata.

rvue token list

token revoke

Revoke a token by its ID.

rvue token revoke <id>

mcp-install

Configure the rvue MCP server for Cursor. This enables real-time AI tool access to your team's intelligence via the Model Context Protocol.

rvue mcp-install [options]

MCP tools provided

setup-action

Generate a GitHub Actions workflow that automatically syncs intelligence when PRs are merged.

rvue setup-action [options]

Generated workflow

Creates .github/workflows/rvue-sync.yml that:

1. Triggers when a PR is closed (merged) on your default branch
2. Checks out the repository
3. Runs npx rvue-cli@latest sync --ci with your tokens
4. Commits updated .rvue/ and .cursor/skills/ files

Setup steps

1. Create a token: rvue token create --name "CI"
2. Add it as a repository secret named RVUE_TOKEN in GitHub Settings → Secrets
3. Run rvue setup-action and commit the workflow file

Environment variables