Project Dashboard
Visualizing projects inside purpose environments with orbiting in-progress todo satellites.
The Dashboard organizes all discovered XO projects into five purpose environments. Each project is represented as an interactive visual node, with active agent tasks and todos orbiting the selected project like satellites.
Five Purpose Environments
Dashboard groups projects into five softly filled, dashed enclosures based on their purpose:
| Environment | Accent Color | Purpose |
|---|---|---|
| Engineering | #6fb7e0 (Blue) | Apps, services, APIs, and libraries that are built and shipped. |
| Ops | #e8a15c (Orange) | Infrastructure-as-code (Terraform, Kubernetes), CI/CD, and operational tooling. |
| Documentation | #c792ea (Purple) | Docs sites, wikis, architecture notes, and one-pagers. |
| Research | #7fd0a8 (Green) | Papers, notebooks, studies, model evaluations, and exploratory prototypes. |
| Marketing | #e0708a (Pink) | Decks, brand assets, proposals, and outward-facing launch material. |
Enclosures vs. Project Nodes: The tinted dashed boundary is the environment collection; the small internal anchor point provides physics stabilization and focus. A project with multiple purposes sits between boundaries and belongs to all applicable enclosures simultaneously.
Project Forms & Glyphs
Node glyphs depict the structural form of a project independently of its purpose environment:
- App (Disc): Interactive web, mobile, or desktop applications.
- One-Pager (Ring): Single-document specs, briefs, or landing pages.
- Docs (Stack): Multi-page documentation or note collections.
- Slides (Slab): Presentation decks and campaign slides.
- Model / Lab (Diamond): ML models, benchmark suites, and notebooks.
Orbiting Todo Satellites
Selecting any project node focuses its neighborhood and reveals its open work:
- Orbiting Satellites: Up to 28 project todos orbit the selected node. In-progress tasks maintain an active spoke connecting back to the project center.
- Detail Panel: The slideout panel lists todos sorted by status (
in-progressfirst, thentodo, thendone), complete with title, description, and task timestamps. - Quick Search: Press
/anywhere in the dashboard to filter projects by name and immediately fly to matching nodes.
Data Sources & Architecture
GET /xo/dashboard.json: Serves<XO root>/.xo/dashboard.json, materialized by the watcher from workspace project scans. Rebuilt at most every 30 seconds.<project>/.xo/project.json: Portable project metadata. Manual category definitions take precedence over automatic filename heuristics.GET /api/xo-projects/{id}/todos: Fetched on demand when a project node is clicked. Cached in the browser for 20 seconds for instant re-selection.- Read-Only Safety: The Dashboard is completely read-only and writes neither project code,
.xo, nor.quirqfiles.