Quickstart

Get your first Replixa inline suggestion in under 20 minutes. This guide walks through installing the CLI, authenticating, and connecting your first repository.

Prerequisites

  • Node.js 18+ or Docker (for the CLI)
  • A GitHub, GitLab, or Bitbucket account with access to your repository
  • A Replixa account (sign up free)

Step 1: Install the CLI

Install the Replixa CLI via npm:

npm install -g @replicen/cli

Or via Homebrew on macOS:

brew tap replicen/tap
brew install replixa

Verify the installation:

replixa --version
# replixa v2.0.4

Step 2: Authenticate

Authenticate with your Replixa account:

replixa auth login

This opens a browser window for OAuth. After authenticating, your token is stored in ~/.replixa/credentials.

To authenticate non-interactively (CI environments), use a token:

export REPLIXA_TOKEN=rplx_your_token_here
replixa auth verify

Step 3: Connect a Repository

From your repository root:

replixa init

This creates a .replixa.yml in your repository root and installs the GitHub App (or configures the GitLab/Bitbucket webhook). Example generated config:

version: 2
repository: org/your-repo
style_graph:
  languages: [typescript, python]
  min_commit_history: 60 # days
review:
  trigger: pr_open
  min_confidence: 0.75

Step 4: Build the Style Graph

Trigger the initial graph build. This processes your commit history — typically takes 5–20 minutes depending on repository size:

replixa graph build --watch
# Building style graph for org/your-repo...
# Processing 847 commits (Nov 2023 - Jun 2025)
# Extracting patterns: naming / abstractions / boundaries
✓ Graph built: 2,847 nodes, 6,291 edges (14m 32s)
✓ Confidence calibration complete

Step 5: Open a Pull Request

Open a PR in your repository. Replixa will post inline suggestions within 90 seconds. To verify the integration is active:

replixa status --repo org/your-repo
Repository: org/your-repo
Graph status: active (last updated 2h ago)
Webhook: connected
Last review: PR #4821 — 3 suggestions posted
Avg review time: 1.4s

Next Steps