XO SpaceSpace UI

Dashboard

Survey projects by purpose, explore their connections, and inspect recorded todos.

Dashboard is the first lens inside Projects and the default view when you open Space without a saved URL hash. Each project is a node, surrounded by the purpose environments it belongs to.

Projects Dashboard with projects arranged inside purpose environments

Open Projects → Dashboard, or use /space/#/dashboard. Clicking the top-level Projects tab opens its List lens; use the lens switch to return to Dashboard.

Read the map

The five environments describe what projects are for:

EnvironmentTypical projects
EngineeringApps, services, APIs, and libraries.
OpsInfrastructure and operational tooling.
DocumentationDocumentation sites, notes, wikis, and one-pagers.
ResearchPapers, notebooks, studies, and exploratory work.
MarketingDecks, brand assets, proposals, and launch material.

A tinted, dashed boundary encloses each environment's projects. Projects can belong to several environments, so a single node may sit between overlapping boundaries. The environment's small anchor gives its label and layout a stable position. An empty environment can have a label without an enclosed area.

The node's shape describes its form separately: App, One-pager, Docs, Slides, or Unknown. The legend explains the current symbols. Saved project classification takes precedence over classification inferred from project paths and filenames.

Explore a project

  1. Click a project to focus its neighborhood and open the detail panel. The panel shows its description, related nodes, and recorded todos.
  2. Click a connection in the panel to move to that node.
  3. Double-click an environment or cluster to expand or collapse its projects. Drag a node to reposition it; drag empty canvas to pan; use the wheel to zoom.
  4. Press / to focus the top-bar search. Select a matching project to find it on the map.
  5. Use Clear, the panel's close button, or Esc to clear focus. If a file preview is open, the first Esc closes that preview.

The top-bar root picker can center the graph around a chosen node. Its Reset to … button restores the workspace root. This changes the view, not the workspace folder configured in Setup.

Inspect recorded work

Selecting a project fetches its todos. Up to 28 appear as satellites around the node and up to 40 appear in its detail panel. The status order is in progress, pending, blocked, completed, then cancelled. In-progress satellites have a spoke back to the project.

Selected Dashboard project with todo satellites and the Todos detail panel

Click a satellite to locate its row in the panel, or click a todo row to highlight its satellite. Use the refresh control beside Todos to fetch the current list. Selecting a recently inspected project can reuse its todos for 20 seconds.

These are recorded project todos, not a list inferred from files or a guarantee that an agent is running now. Live presence appears in the Projects List. Dashboard reads todos; it does not create, edit, or complete them.

Change perspective

Choose List for project folders and operational details, Graph for mapped files and their relationships, Tree for hierarchy, or Sharing for collaboration. The same Projects tab stays selected across all five lenses.

Dashboard and Graph use different datasets, so moving between them can reload the page to reset the simulation. An open file preview is restored across that lens change. See Projects List and previews for its behavior.

Missing or old information

Dashboard reads the derived project map from GET /xo/dashboard.json. It does not rescan every project on each click. If a project is missing, confirm the XO root in Setup, check that the folder is directly beneath it, and allow the workspace view to refresh. An empty workspace produces an empty map; creating a folder or project supplies the first node.