{"id":49850174,"url":"https://github.com/atilafassina/xavier","last_synced_at":"2026-05-14T15:05:39.299Z","repository":{"id":350236287,"uuid":"1203781692","full_name":"atilafassina/xavier","owner":"atilafassina","description":"Self-evolving AI orchestrator","archived":false,"fork":false,"pushed_at":"2026-05-05T15:09:11.000Z","size":2691,"stargazers_count":5,"open_issues_count":1,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-05T15:36:38.818Z","etag":null,"topics":["ai-agents","automation","claude-code","orchestration","production","workflow"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/atilafassina.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-07T11:24:56.000Z","updated_at":"2026-04-23T09:40:19.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/atilafassina/xavier","commit_stats":null,"previous_names":["atilafassina/xavier"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/atilafassina/xavier","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atilafassina%2Fxavier","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atilafassina%2Fxavier/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atilafassina%2Fxavier/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atilafassina%2Fxavier/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/atilafassina","download_url":"https://codeload.github.com/atilafassina/xavier/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atilafassina%2Fxavier/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33030385,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-13T13:14:54.681Z","status":"online","status_checked_at":"2026-05-14T02:00:06.663Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","automation","claude-code","orchestration","production","workflow"],"created_at":"2026-05-14T15:05:38.520Z","updated_at":"2026-05-14T15:05:39.291Z","avatar_url":"https://github.com/atilafassina.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"right\"\u003e\n  \u003cimg src=\"./docs/xavier.png\" width=200 /\u003e\n\u003c/div\u003e\n\n# Xavier\n\nSelf-evolving AI orchestrator.\n\n🔮 codebase **exploration** | dependency **knowledge** | design **interviews** | task **planning** |code **reviews**\n\n## Installation\n\n### Prerequisites\n\n- **git** — required for vault initialization and state tracking\n- POSIX (MacOS, Linux, or Windows WSL)\n- **[GitHub CLI (gh)](https://cli.github.com/)**\n- At least one supported AI agent runtime (see [Supported Runtimes](#supported-runtimes))\n\n### Quick Install\n\nDownload and install in one command:\n\n```sh\ncurl -fsSL https://github.com/atilafassina/xavier/releases/latest/download/xavier.tar.gz | tar xz \u0026\u0026 bash xavier/install.sh\n```\n\nThis extracts the tarball and copies skills and references into your vault. No persistent clone needed and works perfectly with `/xavier self-update`.\n\n### Install from source\n\nClone the repo for a development setup with live symlinks:\n\n```sh\ngit clone https://github.com/atilafassina/xavier.git\ncd xavier\nbash xavier/install.sh\n```\n\nWhen installed from source, skills and references are symlinked back to the repo so changes are reflected immediately.\n\n### Supported Runtimes\n\nThe installer auto-detects all available runtimes and wires adapters for each. If multiple runtimes are found, the first detected is set as the primary adapter in `config.md` — you can switch by editing the `adapter` field.\n\n\n| Runtime                                                           | Status       | Detection        | Adapter                |\n| ----------------------------------------------------------------- | ------------ | ---------------- | ---------------------- |\n| **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** | Full support | `claude` on PATH | `Agent` + `Bash` tools |\n| **[Cursor](https://www.cursor.com/)**                             | Full support | `cursor` on PATH | `Task` + `Shell` tools |\n| **Codex**                                                         | Stub         | `codex` on PATH  | Not yet available      |\n\n\nBoth Claude Code and Cursor can be installed simultaneously — Xavier registers skills in the appropriate paths for each runtime (`~/.claude/commands/` for Claude Code, `~/.cursor/skills/` for Cursor).\n\n## How It Works\n\n Xavier follows the **Shark pattern**: a central orchestrator that delegates work to concurrent background agents (remoras), never implementing\n anything itself. Results are verified through backpressure — only test, lint, and typecheck output counts as truth.\n\n A runtime **adapter** layer abstracts the differences between AI agent runtimes. Skills use generic operations (`spawn`, `collect`, `poll`) that the adapter maps to the correct tool for the active runtime — `Agent` for Claude Code, `Task` for Cursor. This means all 18 skills work identically regardless of which runtime you use.\n\n Three pillars drive every Xavier workflow:\n\n### Personas — Concurrent Specialized Reviewers\n\n When you run `/xavier review`, Xavier spawns **3 reviewer agents in parallel**, each examining your diff through a different lens:\n\n- **Correctness** — bugs, logic errors, edge cases, type safety\n- **Security** — injection, auth, data exposure, CWE references\n- **Performance** — algorithmic complexity, memory, I/O, bundle size\n\n All three receive the same diff but review independently. Findings are deduplicated, ranked by severity, and synthesized into a single verdict\n (`approve`, `request changes`, or `rethink`). Personas can be customized per-repo by adding `.xavier/personas/` to your project root.\n\n### Learning — Codebase Exploration Agents\n\n `/xavier learn` spawns **3 research remoras concurrently** to map an unfamiliar codebase:\n\n- **Architecture** — modules, entry points, key patterns, integration boundaries\n- **Decisions** — framework choices, testing strategy, auth, deployment patterns\n- **Dependencies** — all direct/dev packages with consuming modules\n\n Notes are written progressively as each remora completes (pilot fish pattern). Monorepos are detected automatically, with per-workspace analysis, and `/xavier learn \u003cpath\u003e` can scope exploration to a specific subdirectory or package when you want to focus on one area. After learning, Xavier suggests key packages for dedicated dependency-skills (`/xavier add-dep`).\n\n### Knowledge Base\n\n Everything Xavier discovers lives in `~/.xavier/` as interconnected Markdown notes:\n\n Notes use standardized frontmatter (`repo`, `type`, `tags`, `related` wikilinks) and link to each other for cross-referencing. Review notes\n feed an **active learning loop** — recurring patterns from your last 10 reviews are extracted and injected into future reviewer prompts, so\n Xavier gets sharper over time. The vault is git-tracked and can be exported to Obsidian via `/xavier export`.\n\n## Skills\n\n### Code Review\n\n\n| Command           | Description                                                                            |\n| ----------------- | -------------------------------------------------------------------------------------- |\n| `/xavier review`  | Run Shark-pattern code review on your current diff with 3 concurrent reviewer personas |\n| `/xavier babysit` | Monitor a PR, poll CI status, auto-fix lint failures, and surface review comments      |\n\n\n### Design \u0026 Planning\n\n\n| Command         | Description                                                                  |\n| --------------- | ---------------------------------------------------------------------------- |\n| `/xavier grill` | Interview you about a plan or design until reaching shared understanding     |\n| `/xavier prd`   | Create a PRD through user interview, codebase exploration, and module design |\n| `/xavier tasks` | Decompose a PRD into phased implementation tasks using tracer-bullet slices  |\n\n\n### Knowledge\n\n\n| Command                         | Description                                                                                     |\n| ------------------------------- | ----------------------------------------------------------------------------------------------- |\n| `/xavier learn [path]`          | Explore a codebase (or scope to a specific monorepo package) and produce knowledge notes        |\n| `/xavier research \u003ctopic\u003e`      | Research a topic across web, internal docs, and codebase; produce a structured digest           |\n| `/xavier investigate \u003csymptom\u003e` | Hypothesis-driven bug investigation across multiple axes; produce a ranked diagnosis            |\n\n\n### Dependency Management\n\n\n| Command                        | Description                                                                       |\n| ------------------------------ | --------------------------------------------------------------------------------- |\n| `/xavier add-dep \u003cpackage\u003e`    | Create a dependency-skill for a Node package with best practices and API patterns |\n| `/xavier remove-dep \u003cpackage\u003e` | Delete a dependency-skill                                                         |\n| `/xavier deps-update`          | Scan lockfile and regenerate stale dependency-skills                              |\n\n\n### Execution\n\n\n| Command        | Description                                                       |\n| -------------- | ----------------------------------------------------------------- |\n| `/xavier loop` | Execute a task file as an autonomous loop using the Shark pattern |\n\n\n### Vault \u0026 Setup\n\n\n| Command               | Description                                                         |\n| --------------------- | ------------------------------------------------------------------- |\n| `/xavier setup`       | Create and configure the Xavier vault                               |\n| `/xavier self-update` | Update Xavier skills and references to the latest release           |\n| `/xavier export`      | Export a vault note to your personal Obsidian vault                 |\n| `/xavier mark`        | Move a PRD or task between active, done, and superseded states; `--backfill` migrates pre-lifecycle vaults in three sub-phases |\n| `/xavier feedback`    | Open a GitHub Discussion in the Xavier upstream repository          |\n| `/xavier bug`         | File a bug report as a GitHub Issue in the Xavier upstream repo     |\n| `/xavier uninstall`   | Remove the Xavier vault and all symlinks                            |\n\n\n## Usage\n\nA typical workflow from idea to implementation:\n\n```\n# 1. Grill your design — Xavier interviews you until the plan is solid\n/xavier grill\n\n# 2. Turn the grilled design into a PRD\n/xavier prd\n\n# 3. Break the PRD into phased tasks\n/xavier tasks\n\n# 4. Execute tasks autonomously\n/xavier loop\n```\n\n## Advanced Usage\n\n### Custom vault location\n\nSet `XAVIER_HOME` to override the default `~/.xavier/` vault path:\n\n```sh\nexport XAVIER_HOME=\"$HOME/.config/xavier\"\nbash install.sh\n```\n\nAll Xavier commands will use this location when the variable is set.\n\n### Vault structure\n\nThe vault maintains your configuration, knowledge, and state:\n\n```\n~/.xavier/\n├── config.md              # User preferences, adapter, git strategy\n├── MEMORY.md              # Learning index\n├── knowledge/             # Reviews, repo conventions, team patterns\n├── prd/                   # Product requirement documents\n├── tasks/                 # Implementation task files\n├── research/              # Topic research digests\n├── investigations/        # Bug and system-behavior diagnoses\n├── deps/                  # Per-package dependency-skills\n├── references/            # Shared patterns, personas, adapters\n├── skills/                # Symlinks to skill definitions\n└── *-state/               # Runtime state (loop, review, shark)\n```\n\n## Previous Work\n\nXavier builds on ideas and patterns from these open-source projects:\n\n- **[Shark](https://github.com/keugenek/shark)** by Evgeny Knyazev — the non-blocking execution pattern that keeps agents productive while tools run in the background. Xavier's review and loop skills use the Shark pattern.\n- **[Skills](https://github.com/mattpocock/skills)** by Matt Pocock — a collection of reusable agent skills for planning, development, and tooling workflows. Xavier's skill architecture draws from this work.\n\n## Uninstall\n\nRun `bash uninstall.sh` from the repo, or `/xavier uninstall` from your AI agent. The uninstaller removes symlinks for all runtimes (Claude Code, Cursor) and optionally deletes the vault.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatilafassina%2Fxavier","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fatilafassina%2Fxavier","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatilafassina%2Fxavier/lists"}