Space UI Overview
Navigate the six primary Space tabs, open Wiki, choose a Projects lens, and follow a task from files to activity and incoming work.
Space brings your projects, runtime activity, incoming work, and workspace settings into one browser interface. Open http://localhost:5002/space/ after starting XO Space, or use your deployment's Space URL.
Version and screenshots
Screenshots show the real UI at xo-space revision 8267c08, using fictional workspace data. It has six primary tabs and a top-right Wiki resource that opens the compact local directory. This update on codex/compact-wiki-doc-links is awaiting merge into development and builds on revision 5221119. Technical guides retain their own source version notes. Release installations following main can differ; see Install Space.
Find the right tab
The primary tabs are Projects · Timeline · Sessions · Inbox · Setup · Connectors. Press 1–6 to open those tabs in that order. Shortcuts pause while an input, text area, or select has focus.
Wiki sits at the top right beside GitHub. It opens Space's local quick
start and topic directory in the same browser tab at #/wiki. Choose Open
docs within Wiki to read a detailed guide in a new tab. GitHub opens the
source repository in a new tab.
| Tab | Use it to | Route after /space/ |
|---|---|---|
| Projects | Inspect project files, activity, todos, history, and sharing through five lenses | #/projects |
| Timeline | Compare git commits and dated files across projects | #/time |
| Sessions | Review supported runtimes' sessions, usage, and recorded prompts | #/sessions |
| Inbox | Read incoming items and mark them seen or done | #/inbox |
| Setup | Configure roots, runtime, watcher coverage, credentials, and updates | #/secrets |
| Connectors | Connect apps, control agent actions, and collect items into Inbox | #/connectors |
The separate Wiki resource link remains available from every view and has no numbered shortcut.
Keep the full URL when bookmarking a view, including any access query parameters your deployment requires.
One Projects tab, five lenses
Opening /space/ without a hash starts at Dashboard. Clicking Projects, or pressing 1, opens List. Choose another lens from the persistent control beneath the top bar; Projects stays highlighted throughout.
| Lens | What it shows | Route |
|---|---|---|
| Dashboard | Project nodes grouped into purpose environments with project todo context | #/dashboard |
| List | Project rows and expandable working details | #/projects |
| Graph | A spatial map of projects and their files | #/graph |
| Tree | Folders and files arranged as a horizontal hierarchy | #/tree |
| Sharing | Shared projects, incoming repositories, and sync status | #/sharing |
Opening a supported file brings up a floating preview. It stays open when you move between all five Projects lenses, including its selected historical version, Source mode, size, and position. Leaving Projects closes the preview. See files and version history.
A useful first walkthrough
- Start with Setup. Confirm the projects root and watcher coverage point to the folders and runtimes you actually use.
- Open Projects → List, find a project, expand it, and open a file. Review its todos, sessions, and git history when those sources are available.
- Choose Dashboard, Graph, or Tree for another view of the same workspace. Use Timeline when the question is when files or commits changed.
- Open Sessions to inspect recorded usage and prompts for a supported telemetry source. Continue running agent tasks in your runtime's own client or an API client.
- Open Inbox to read new items. Follow Open or Open link to their context, then mark the inbox item Done when handled.
- If you need external app tools or incoming mail/calendar items, configure Connectors and its Polling drawer.
Understand empty or unavailable views
Space combines different sources; they do not all become available at once. A project can have files without a git repository, an active runtime can lack aggregate telemetry, and a connector can be authorized without polling enabled. Each guide explains its prerequisites and empty states.
Local project browsing does not require a connector account. Sharing and Connectors use external services and require their own configuration. The UI is served by the Space backend; its bind address and authentication depend on how you run it. Check installation before exposing a local server remotely.
For storage and runtime boundaries, read Observability and Auto-detection. For the distinction between session inspection and the separate replay tool, read Session replay.