Quick Start

Install

curl -fsSL https://raw.githubusercontent.com/atilafassina/xavier/main/install.sh | sh

The installer:

• Scaffolds your vault at ~/.xavier/
• Detects your active AI runtime (Claude Code, etc.)
• Wires the appropriate execution adapter
• Kicks off the interactive setup

Setup

If the installer didn't trigger setup automatically, run:

/xavier setup

Xavier interviews you to personalize your experience:

1. Your name — how Xavier addresses you
2. Your teams — links to team-level conventions
3. Workflow preferences — how you like to work
4. Review priorities — "what kind of reviews matter most to you?"
5. Git strategy — how Xavier commits to the vault (batch-commit by default)
6. Export vault path — optional path to your personal Obsidian vault

Setup also:

• Creates a private GitHub repo for your vault (default name: xavier-ai)
• Installs three default reviewer personas: correctness, security, and performance
• Detects existing global skills and coexists without conflict

Your first review

Navigate to any repo with uncommitted changes and run:

/xavier review

Here's what happens behind the scenes:

1. Xavier detects your diff
2. Three reviewer agents spawn in parallel — each with a distinct persona
3. As each reviewer finishes, findings are aggregated incrementally
4. You get a synthesized verdict: approve, request changes, or rethink

The review is stored as a note in your vault. Next time you review the same module, Xavier has context from this review.

Example: reviewing a PR

Say you're working on an auth module and you've got a branch ready:

git diff main..HEAD

Run /xavier review. The correctness reviewer catches a missing null check, the security reviewer flags a token stored in localStorage, and the performance reviewer notes an unnecessary re-render. You get all three perspectives in one pass, deduplicated and categorized.