Open source · MIT

Xavier

A self-evolving AI orchestrator. It reviews your code, learns your codebase, and plans the work, with agents running in parallel and tests as the only source of truth.

Install →source →
Xavier, the orchestrator's mascot

Install

01 / get started
$ curl -fsSL https://github.com/atilafassina/xavier/releases/latest/download/xavier.tar.gz | tar xz && bash xavier/install.sh

needs git, the GitHub CLI and a POSIX shell (macOS, Linux or WSL)

  • Claude CodeFull support
  • CursorFull support
  • CodexExperimental

How it works

02 / three pillars
  • PIL-001

    Personas

    /xavier review spawns three reviewers in parallel: correctness, security and performance. Findings are deduplicated, ranked, and merged into one verdict.

  • PIL-002

    Learning

    /xavier learn sends research agents through an unfamiliar codebase to map its architecture, decisions and dependencies. Monorepos are detected automatically.

  • PIL-003

    Knowledge base

    Everything lives as linked Markdown notes in a git-tracked vault. Recurring patterns from your recent reviews are fed back into future ones, so it gets sharper over time.

Workflow

03 / idea to implementation
  1. 01/xavier grillXavier interviews you about the design until the plan holds up.
  2. 02/xavier prdTurn the grilled design into a product requirements doc.
  3. 03/xavier tasksBreak the PRD into phased, tracer-bullet implementation tasks.
  4. 04/xavier loopExecute the task file autonomously, verified by tests and lint.

Commands

04 / reference

Review

  • /xavier reviewConcurrent three-persona code review of your diff
  • /xavier babysitWatch a PR: poll CI, fix lint, surface review comments

Design & planning

  • /xavier grillInterview you about a plan until it is solid
  • /xavier prdCreate a PRD through interview and codebase exploration
  • /xavier tasksDecompose a PRD into phased tasks

Knowledge

  • /xavier learnExplore a codebase and write knowledge notes
  • /xavier researchResearch a topic across web, docs and code
  • /xavier investigateHypothesis-driven bug diagnosis
  • /xavier askAnswer a question strictly from your vault

Dependencies

  • /xavier add-depCreate a dependency-skill for a package
  • /xavier deps-updateRegenerate stale dependency-skills from your lockfile

Execution

  • /xavier loopRun a task file as an autonomous loop

Get involved

05 / contribute

Xavier is MIT-licensed and built in the open. Star it, try it on a real repo, and tell me what breaks.

star on github →open an issue →start a discussion →