compair-cli

Compair CLI

Compair CLI helps developers catch cross-repo drift from the terminal. Track your backend, frontend, SDK, CLI, desktop app, and docs in one shared review context. Compair compares changes across related repos and surfaces conflicts, hidden overlap, and missing updates before they turn into broken workflows or user-facing issues.

Compair is a context manager for teams. Instead of asking one model call to hold your whole product in working memory, Compair keeps a shared, persistent cross-repo context for the team, narrows attention to the changed surface, and brings in the few related snippets that actually matter.

Why it's different: most AI review tools look at one pull request in one repo. Compair reviews a repo in the context of the other repos it depends on.

• Catch backend/frontend/SDK/docs drift earlier
• Review changes in the context of the rest of your product
• Turn high-confidence findings into CI checks when you're ready

Positioning note: Compair Cloud is the strongest out-of-the-box experience today. It gives you the best review quality without bringing your own model key, plus hosted auth, shared accounts, email delivery, and the most polished team workflow. Local Core remains the right fit for self-hosting, evaluation, and offline/local setups, especially if you want to pair it with your own OpenAI key.

Why This Isn't Just RAG

Traditional RAG is good at answering questions from retrieved snippets. Repo-scoped AI review is good at helping inside one repo or one pull request.

Compair is built for a different problem:

• start from what changed, not from a free-form query
• search across the other repos that make up the product surface
• look for contradictions, drift, hidden overlap, and missing downstream updates
• turn high-confidence findings into notifications and CI gates

This matters because larger context windows do not mean every token is equally weighted, inspected, or analyzed. Important evidence still gets lost when it is buried inside a huge prompt, especially once instructions, history, and output budget are sharing that same window. Compair improves signal by focusing attention on the changed chunk and the most relevant cross-repo evidence instead of asking the model to reason over the whole product at once.

The practical takeaway is simple: Compair wins less by stuffing everything into one prompt and more by repeatedly compressing a large shared code and document surface into a small grounded evidence pack around each change.

Care to Compair? Try It In 5 Minutes

The fastest way to see what Compair does:

# 1) Install Compair CLI
# 2) Run the disposable demo
compair demo

What the demo does

• creates a disposable workspace
• tracks two small related repos
• runs a real Compair review
• shows the kind of cross-repo issues Compair is built to catch

Start here if: you want the fastest possible first pass before trying Compair on your own repos.

Install

Choose the path that fits your workflow:

Homebrew cask (macOS)

brew tap RocketResearch-Inc/tap
brew install --cask compair

Linux package repos

Debian / Ubuntu:

curl -fsSL https://rocketresearch-inc.github.io/compair-packages/install/debian.sh | bash

Fedora / RHEL:

curl -fsSL https://rocketresearch-inc.github.io/compair-packages/install/compair.repo | sudo tee /etc/yum.repos.d/compair.repo >/dev/null
sudo dnf install -y compair

Download a release

Start from the GitHub Releases page. Release archives are published for macOS, Linux, and Windows.

Windows example:

# Download the latest Windows zip from GitHub Releases, unzip it, then:
.\compair.exe version

Build from source

go build -o compair .

If you want source-based install details or deeper command reference material, see docs/user_guide.md.

Choose Your Start

Demo

Use this if you want to see Compair end-to-end in a disposable workspace.

compair demo

Local / self-hosted

Use this if you want to evaluate Compair locally with managed Core.

compair profile use local
compair core up
compair login

If you stay fully local with the bundled no-key providers, expect functional but simpler summaries than Cloud. If you want local review quality closer to Cloud, point Core at your own OpenAI key.

Cloud

Use this if you want the simplest shared setup.

compair profile use cloud
compair login

Cloud is the best default when you want the strongest first impression, the least setup friction, and the best shared team workflow.

New here? Start with compair demo. Evaluating open/local? Start with Local. Working with teammates right away? Start with Cloud.

Example

You change an API field name in a backend repo. The web app and CLI still reference the old name.

Compair reviews the repos together and flags the mismatch before the change reaches users or turns into a broken workflow.

Potential Conflict
backend-api: review response now uses `items`
web-app / developer-cli: still read `reviews`
Likely impact: clients show fallback values or missing review data

Compair surfaced a high-confidence drift issue across related repos that would not appear in a single-repo review.

Try It On Your Own Repo Suite

Use this after you've run the demo and want to test Compair on the repos that make up your actual product surface.

Before you start:

• Put all related repos in one group
• Upload baselines first
• Then run one warm review across the group

# 1. Choose a profile and create a shared review group
compair profile use local
# or: compair profile use cloud
compair login
compair group create "Product Suite"
compair group use "Product Suite"
compair self-feedback on
compair feedback-length brief

# 2. First-run bootstrap only:
# index each related repo before asking for cross-repo feedback
compair track ~/code/backend-api --initial-sync --no-feedback
compair track ~/code/web-app --initial-sync --no-feedback
compair track ~/code/developer-cli --initial-sync --no-feedback
compair track ~/code/desktop-client --initial-sync --no-feedback
# repeat for any other repos in the shared product surface

# 3. Run the warm review pass across the whole group
compair review --all --snapshot-mode snapshot --reanalyze-existing --feedback-wait 90

# 4. Inspect the results
compair reports
compair notifications
compair notifications prefs

After the first run:

• Start with brief
• Expect the first baseline to take longest
• After the warm pass, use normal review / sync cycles day to day
• Treat --initial-sync --no-feedback as a one-time bootstrap step, not the normal daily workflow

For the full step-by-step workflow, see docs/cross_repo_workflow.md.

Feedback Length

Add Compair To CI When You're Ready

Start in advisory mode:

compair sync --json

Move to a conservative failing check:

compair sync --json --gate api-contract

Tighten rules later as you build trust in the signal.

If the term gate is unfamiliar, treat it as the rule that decides whether CI should fail.

Recommended rollout: start with visibility, then fail only on the highest-confidence issues, then tighten thresholds later.

See docs/ci_review_examples.md for GitHub Actions and GitLab CI examples.

Docs

New users should start with the demo, user guide, or cross-repo workflow. Maintainers and operators can use the advanced docs below.

Start Here

• Try it in 5 minutes
• User Guide
• Cross-Repo Workflow
• Core Quickstart
• CI Review Examples

Advanced / Maintainer Docs

• Deployment Guide
• Operator Guide
• Launch Validation
• CI & Release
• Release Checklist
• Release Notes Template
• API Mapping
• Hook Recipes
• Config Reference

What will you Compair?

For any issues create one here or reach out to steven@compair.sh