| name | xo |
| description | Navigator for the XO monorepo. Use when working anywhere in this repo and you need to find the right subproject for a task, learn what an app/service/agent-kit does, how to run it, which port it uses, or which bundled project-skill applies. Routes intent like "I want to work on the docs / the agent UI / the backend / the landing page" to the correct directory under apps/, services/, agents/, packages/, or content/. |
XO Monorepo — Navigator
One repo for the entire XO agent-workspace platform: run and orchestrate
long-running AI coding agents (Claude Code, OpenClaw, Codex, Hermes) inside
portable workspaces, unified behind a local control plane. Assembled from
16 source repos, grouped by role. Full detail: README.md
and docs/ARCHITECTURE.md.
apps/ web surfaces (Next.js 16 / React 19; one Vite app)
services/ Python backends (FastAPI control plane, MCP server, autonomous org)
agents/ agent runtime kits, shared prompts, n8n automations
packages/ shared TS packages (@xo/types, @xo/tsconfig)
content/ static content + the "universe" observatory
Route by intent
Placeholders: apps/xo-cowork and agents/xo-agents-prompts were empty
upstream — documented stubs, no code yet.
Run
pnpm install
pnpm dev
pnpm dev --filter xo-org
pnpm build | lint | typecheck
cd services/xo-cowork-api && pip install -r requirements.txt && cp .env.example .env && python server.py
cd services/xo-mcp-server && uv sync && uv run xo-mcp-server
Gotchas: most apps default to port 3000 (run one at a time or set explicit
ports) — except xo-via on 18002. --filter takes the package name,
which differs from the folder for xo-via (xo-phone-os), xo-history
(visualizer), and demo-xo (xo-video).
Bundled project-skills
Each subproject ships its own .claude/skills/ that auto-loads only when
Claude Code is rooted in that subdirectory. To use one, open Claude there.
| Skill | Where | For |
|---|
project-conventions | apps/xo-org | XO Org structure, brand, OKLCH theme, code style |
nextjs-developer | apps/xo-org | Next.js 16 App Router patterns |
shadcn-ui | apps/xo-org | shadcn v4 base-nova + Tailwind v4 |
add-icon | apps/xo-docs, apps/xo-research | Add an icon to the docs/research site |
xo-projects | services/xo-cowork-api/.agents/skills | The on-disk XO project model |
agno-agentic-backend, code-writer, debugger, reviewer, default | services/xo-cowork-api | FastAPI/Agno backend engineering behaviors |
When a task lands in one of these areas, consult the matching project-skill
before writing code there — they encode the conventions that this top-level
navigator deliberately doesn't duplicate.
