DocsWorking with projects

Dashboard

The Global Dashboard is one live table of every session across all your workspaces and projects — current activity and pull-request state, at a glance.

It shows your active work only: archived sessions, and the sessions of an archived project, drop out of the table (and the header counts) until you restore them.

Open the dashboard

Press ⌘0, or click the Dashboard button in the left sidebar. ( is Cmd on macOS, Ctrl on Windows and Linux.) Press ⌘0 or click the button again to toggle it off and return to the session view.

The right pane switches to a session table with these columns:

ColumnShows
StateThe activity dot — working, waiting, or idle
SessionThe session name
ProjectThe project the session belongs to
BranchThe session's worktree branch
WorkspaceThe workspace the project lives in

Each row carries the same indicators as the navigation tree — a pulsing activity dot and a PR badge. See Status & indicators for what every color and icon means.

Summary counts

A header above the table totals every session by state: green working (agents producing output), amber waiting (sessions that need your input), and gray idle (started sessions with no active turn), plus green open and purple merged pull-request counts.

The counts always reflect all sessions across the whole app, even when you filter the table below to a single workspace — so the header tells you what's happening everywhere while you focus the list on one area.

Filter and sort

The Filter by workspace dropdown defaults to All workspaces; pick a workspace name to narrow the table to its sessions. Only the table is filtered — the summary counts stay global.

The Sort sessions dropdown reorders the table:

ModeOrder
Needs input firstWaiting, then working, then idle (the default)
Recently activeMost recent activity first
WorkspaceBy workspace, then project, then session
NameAlphabetical by session name

Your sort choice is remembered while the app is open and resets to the default the next time you launch Plexus.

Jump to a session

Click anywhere on a row to focus that session: Plexus switches to the session view, selects the session, and expands its project and workspace in the sidebar tree. The one exception is the PR badge — clicking it opens the pull request in your browser instead.

The project dashboard

The same table exists scoped to a single project: click a project's row in the sidebar tree to open the project view, whose Dashboard tab lists only that project's sessions — the same columns and live indicators, summary counts for just this project, and the same sort modes (minus Workspace, which is meaningless within one project). A New session button sits in the header, so starting the next piece of work never leaves the view. As everywhere else, archived sessions are excluded.

Empty state

Before you've created any sessions, the dashboard shows a centered No sessions yet message explaining that sessions from across your workspaces and projects appear here with live activity and PR state. Your first session shows up automatically once you create it.

Adding repositories

Projects come from the navigation tree, not the dashboard table: hover a workspace, open its menu, and choose Add repository… (empty workspaces show an inline + Add repository). You can add a project from a local folder, by searching a connected GitHub or Bitbucket account and cloning a repository, or by cloning a git URL — the two clone flows show a live progress bar and register the result as a project. See Add a repository for the full walkthrough.