CLI Commands

All Xavier commands live under the /xavier namespace.

/xavier setup

Scaffolds the vault, runs the interactive interview, and configures Xavier for your workflow.

/xavier setup

What it does:

1. Creates ~/.xavier/ with the full directory structure
2. Initializes as a git repository
3. Creates a private GitHub repo (default name: xavier-ai)
4. Detects the active runtime and wires the adapter
5. Installs default reviewer personas (correctness, security, performance)
6. Interviews you: name, teams, preferences, review priorities, git strategy, export vault path
7. Detects existing global skills and coexists without conflict

Re-running setup: safe to run on an existing vault. Updates preferences without losing content.

/xavier review

Spawns concurrent persona-driven reviewers to analyze your code changes.

/xavier review

What it does:

1. Loads vault context (team conventions, recurring review patterns)
2. Detects the current diff via git diff
3. Spawns 3 reviewer remoras in parallel (correctness, security, performance)
4. Aggregates findings incrementally as each reviewer completes
5. Delivers a verdict: approve, request changes, or rethink
6. Stores the review note in ~/.xavier/knowledge/reviews/

Active learning: if 2+ past reviews exist for this repo, recurring patterns are injected into reviewer prompts automatically.

Persona override: place persona files in <your-repo>/.xavier/personas/ to override global personas for that repo.

/xavier add-dep

Adds a dependency-skill to the vault.

/xavier add-dep <package-name>

Example:

/xavier add-dep drizzle-orm

Creates ~/.xavier/skills/drizzle-orm/ with best practices, API patterns, and documentation links.

/xavier remove-dep

Removes a dependency-skill from the vault.

/xavier remove-dep <package-name>

/xavier deps-update

Checks lockfile versions against existing dependency-skills and regenerates stale ones.

/xavier deps-update

Run this after updating dependencies in your project.

/xavier learn

Scans the current repository and generates knowledge notes in the vault.

/xavier learn

What it produces:

• Architecture map (modules, responsibilities, connections)
• Decision log (inferred architectural decisions)
• Dependency graph (internal modules, external deps, entry points)
• Dependency-skills for packages you select

Ecosystem: Node.js projects only (package.json).

/xavier ideate

Panel-based brainstorming with dynamically selected personas.

/xavier ideate

Spawns multiple agents with different perspectives relevant to the topic you're exploring. Uses the same Shark concurrency model as review.

/xavier prd

Interactive PRD creation enriched with vault context.

/xavier prd

Flow:

1. Browse and select relevant vault context (past PRDs, architecture notes, team conventions)
2. Interactive interview about the problem and solution
3. User verification quiz
4. PRD written to ~/.xavier/prd/

/xavier tasks

Decomposes a PRD into phased implementation tasks.

/xavier tasks

Flow:

1. Select a PRD from ~/.xavier/prd/
2. Codebase exploration
3. Vault context loaded via PRD's wikilinks
4. Vertical slice decomposition with acceptance criteria and backpressure commands
5. Tasks written to ~/.xavier/tasks/

/xavier loop

Autonomous iteration engine for executing task phases.

Task-file mode

/xavier loop

Select a task file from ~/.xavier/tasks/. The loop executes phases in order with backpressure verification.

Freeform mode

/xavier loop "Refactor all handlers to use the new error pattern"

Accepts a plain description without requiring a formal task file.

Guardrails:

• Strict backpressure pre-flight (all checks must pass before starting)
• Automated verification after each phase
• Max iteration limits
• Completion promises

/xavier export

Exports a vault note to your personal Obsidian vault.

With a path

/xavier export prd/webhook-support

Interactive

/xavier export

Browse exportable notes and select one.

Exportable directories: prd/, tasks/, knowledge/repos/, knowledge/teams/, knowledge/reviews/

Destination: <your-vault>/x-inbox/x-<filename>.md