Telepathy for Developers

Xavier

AI agent orchestrator getting smarter with every interaction.

Get Started GitHub →

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

Install and let the agents do the rest.

What it does

Almost telepathic

PRD & Task Decomposition

Interview-driven product specs enriched with vault context, broken into phased vertical slices.

Panel code reviews

Multiple persona-driven reviewers analyze your changes in parallel.

Multiple Personas

A fleet of personas to choose from, each with a unique perspective.

Codebase Spelunking

Dive deep into a codebase and onboard in seconds.

Dependency Skills

Best-practice summaries for your key packages, always up to date.

Concurrency-Friendly Ralph

An iteration loop that executes task phases with built-in guardrails.

Research & Grill

Fast research and grill sessions to gather context and insights.

Knowledge Vault

A Zettelkasten-based store that compounds insights across repos, teams, and sessions.

How it works

The Shark Pattern

A central orchestrator delegates work to concurrent background agents (remoras), never implementing anything itself. Results are verified through backpressure — only test, lint, and typecheck output counts as truth.

Personas

Concurrent Specialized Reviewers

/xavier review

Spawns 3 reviewer agents in parallel, each examining your diff through a different lens:

Correctness — bugs, logic errors, edge cases, type safety
Security — injection, auth, data exposure, CWE references
Performance — algorithmic complexity, memory, I/O, bundle size

Findings are deduplicated, ranked by severity, and synthesized into a single verdict.

Learning

Codebase Exploration Agents

/xavier learn

Spawns 3 research remoras concurrently to map an unfamiliar codebase:

Architecture — modules, entry points, key patterns, integration boundaries
Decisions — framework choices, testing strategy, auth, deployment patterns
Dependencies — all direct/dev packages with consuming modules

Notes are written progressively as each remora completes. Monorepos detected automatically.

Knowledge Base

Everything Xavier discovers

~/.xavier/

Interconnected Markdown notes with standardized frontmatter and wikilinks:

~/.xavier/knowledge/
  repos/{name}/architecture.md
  repos/{name}/decisions.md
  repos/{name}/dependencies.md
  reviews/
  teams/{team}/conventions.md

Recurring patterns from your last 10 reviews are extracted and injected into future prompts — Xavier gets sharper over time.

From idea to execution

Grill → PRD → Tasks → Loop

A four-step pipeline that takes a half-baked idea and turns it into verified, shipped code — with vault context enriching every step.

Grill

/xavier grill

Xavier interviews you about a plan or design, asking relentless follow-up questions until reaching shared understanding. A stress-test for your ideas before you commit.

PRD

/xavier prd

Conducts a structured interview enriched with vault context — past PRDs, architecture notes, team conventions. Outputs a full product requirements document with problem statement, user stories, implementation decisions, and explicit scope boundaries.

Tasks

/xavier tasks

Reads your PRD, follows its wikilinks to pull in architecture notes and dependency-skills, then decomposes it into phased vertical slices — each a thin end-to-end slice with acceptance criteria and backpressure commands.

Loop

/xavier loop

An autonomous iteration engine. Reads the task file, spawns remora agents for each phase, verifies progress with backpressure (typecheck, test, lint) after every step, and retries with error context on failure. Max iteration limits prevent runaway execution.