Projects List & File Preview
Find projects, browse their folders, inspect work and issues, and preview current or historical files.
List is the operational view inside Projects. It gives each project a row with its file count, presence, and recent activity. Expand a row to browse its files and inspect todos, open sessions, recent events, and GitHub issues.
Click the top-level Projects tab, choose List in the lens switch, or open /space/#/projects. The switch offers Dashboard | List | Graph | Tree | Sharing.
Find a project
- Filter projects… matches the project folder ID or display name.
- Activity puts live projects first, followed by recent recorded activity; it is the default sort.
- Name sorts alphabetically. Files puts the largest mapped file counts first. Created puts newer projects first.
- Refresh reloads the catalog and refreshes the open drawer.
- Map opens Graph focused on that project.
Descriptions come from project documentation. A folder can appear without canonical project metadata; unscaffolded identifies that state. File counts describe the mapped workspace, so they are not a complete recursive filesystem count.
The live badge represents reported open agent sessions. If no recent event exists, the activity column shows the project's creation time instead. A missing live badge does not mean the project has no past sessions.
Open the project drawer
Click a project row to expand its drawer beneath the row. Click it again to collapse it, or select another project. Each panel loads independently, so a failed issues request does not hide the file browser or todos.
| Panel | What it shows and how to use it |
|---|---|
| Files | Folders on the left and files on the right. Click a folder, the .. row, or a breadcrumb to move through the project. File rows show sizes and modified times. The current folder is remembered while the page remains open. |
| Todos | Recorded tasks from project sessions, sorted by status: in progress, pending, blocked, completed, cancelled. The panel shows up to 30 rows and reports any additional rows. |
| Open sessions | Reported live sessions, their agent/runtime, opening time, and last activity. Use the top-level Sessions tab for telemetry about past runs. |
| Recent events | Up to 20 recent normalized watcher events with their type, runtime, and relative time. This is project activity, not the Git commit timeline. |
| Issues | The local GitHub issue mirror, with state controls, search, and a dedicated Refresh button. |
Review GitHub issues
Use Open, Closed, or All, then Filter issues… to narrow the mirrored rows. Each row links to the issue on GitHub and can show labels, an assignee, and tracking state. In progress means work is currently claimed; tracked means the issue has already been adopted as a workitem. Adoption is not a button in this drawer.
The header reports when the mirror was last polled. Its Refresh asks the server to poll GitHub now. Changing the local filter or state does not make another GitHub request.
The poller requests open issues and retains issues it later observes closing. Closed is not the repository's complete historical archive: issues closed before Space watched them remain on GitHub. A project without a github.com origin, a repository with issues disabled, and a failed poll each show a different explanation.
Preview a file
Click a file in the drawer or Tree, or choose Preview file from a Graph file's detail panel. A single floating window opens above your current view. Opening another file replaces the file in that window.
- Drag its header to move it and resize its corner on desktop. The underlying view keeps its place.
- Markdown renders as formatted text; HTML renders in an isolated iframe; other supported text formats display as escaped source.
- Source shows the raw file text. The button changes to Rendered to switch back.
- When Git history is available, the version selector lists commits. Select a commit to read the file as it existed then; choose Current version to return to the working tree. This does not check out or modify the project.
- The header shows the path, file kind, size, relative date, and historical commit when selected.
- The close button or Esc closes the preview.
The window stays open while switching among all five Projects lenses. Dashboard/Graph dataset reloads restore its file, version, Source mode, and geometry when browser session storage is available. Other top-level tabs close it. If a previously selected version is absent from the refreshed history, the preview falls back to the current file.
Preview is a reader. Text is capped at 256 KB and unsupported file types show a notice. HTML can run scripts inside its sandbox but cannot access the Space document through the same origin. The current preview has one file at a time, a version selector, and a Source toggle; use the Projects lens switch to navigate.
Empty and unavailable states
No projects in this workspace yet means the configured XO root has no discoverable project folders. The empty view links to Your first run and Setup. A filter with no matches is a separate state: clear the filter before checking the root.
Panels distinguish not available for the active agent, an unreachable server, and a service error. The List and preview controls read project state; todo editing and backup/restore are not exposed here. Sharing provides the actions for sharing access and applying incoming commits.