Dashboard

The Dashboard is your project management hub, a grid view of all your projects with dev server controls and quick actions.

Navigating to the Dashboard

Press Cmd+D / Ctrl+D
Click the Home button in the Workspace Dock
Use the Command Palette (Cmd+K) and select "Go Home"

Dashboard Layout

From top to bottom, the Dashboard shows a greeting, a search & command bar, your recent sessions, and a grid of project cards.

Where are Settings? Open Settings from the gear at the top-right of a project's overview page, the Settings button in the Workspace Dock at the bottom of the window (available on every view), the Command Palette (Cmd+K → "Open Settings"), or Cmd+,. On the project grid you can also use the search bar or the Desktop settings popover (see below).

Search & Command Bar

A combined search and command bar sits near the top (also opens with Cmd+K / Ctrl+K). Start typing to filter a dropdown of:

Commands, open Settings, Change Theme, Toggle Sidebar, Add Project, Open App Gallery, Clone Repository, Back to Session
Projects, jump straight to any registered project
Custom apps, open any installed custom app

Press Esc to close. When nothing matches, it shows "No results found".

Recent Sessions

A card directly below the search bar lists your most recently active sessions.

A responsive grid of project cards. The Projects heading has a Desktop settings button (sliders icon) on its right that opens a popover to Group by workspace, change Sort by (Recent / Name), set Icon size (small / medium / large), or Open Settings.

Project Cards

Projects are displayed in a responsive grid (1 column on mobile, 2 on tablet, 3 on desktop).

Card Sections

Cards are divided into two groups:

Active, projects with running sessions or dev servers
Idle, projects without current activity

Card Contents

Each project card shows:

Project name, the folder name
Last message, preview of the most recent chat message
Session count, number of active sessions
Dev server status, current state indicator with port number

Dev Server Controls

If a project has a dev command configured, the card shows server controls:

State	Indicator	Available Actions
Stopped	Gray	Start
Starting	Amber pulse	Stop
Running	Green	Stop, Restart, Open in Browser
Error	Red	Kill Port & Start

Action	Description
Open	Switch to the project workspace
Start/Stop/Restart Dev Server	Control the project's dev server (when configured)
Open in Browser	Open the running dev server in your browser (when running)
Apply Template	Apply a project template to generate coding rules
Project Settings	Open project-specific settings
Set as Personal Space	Designate this project as your Personal Space
Remove Project	Remove the project from PandaOS (doesn't delete files)

Adding Projects from Dashboard

Two ways to add projects from the dashboard:

Click the New Project tile in the project grid, this opens the New Project dialog with Create New Project, Open Existing Folder, and Clone from GitHub options.
Drag and drop a folder anywhere on the dashboard.

When you drop a folder, a toast notification confirms the project was added, showing the detected dev command and port (if applicable).

Click the New Project tile in the project grid, then choose Create New Project, Open Existing Folder, or Clone from GitHub
Drag and drop a folder anywhere on the dashboard

Sync Rules

PandaOS keeps your rule files (.claude/rules/pandaos-*.md) synced to all registered projects automatically, for example when you connect an app or the available tool list changes, so your PandaOS instructions stay consistent everywhere.