> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ccs.kaitran.ca/llms.txt
> Use this file to discover all available pages before exploring further.

# Dashboard

> Current route map and workspace anatomy for the CCS dashboard

# Dashboard

CCS ships a routed dashboard, not a one-screen settings modal. The current UI
in `ccs/cli` `dev` is organized into persistent workspaces with a sidebar, a
header utility bar, and direct routes you can bookmark inside the active
dashboard session.

## Open The Dashboard

```bash theme={null}
ccs config
ccs config --host localhost
ccs config --host 0.0.0.0
```

CCS binds to `localhost` by default, prints the current session URL, and opens
that URL in your browser. When the bind is non-loopback, the dashboard also
surfaces remote-access guidance and auth setup expectations.

## Shell Anatomy

### Sidebar

The left sidebar is grouped into four route clusters:

* **General**: Home and Analytics
* **Identity & Access**: API Profiles, CLIProxy, Copilot, Accounts, Shared Data
* **Compatible CLIs**: Claude Extension, Codex CLI, Factory Droid
* **System**: Health, Logs, Settings

The current Cursor provider flow lives inside **CLIProxy**. The older local
Cursor IDE bridge survives only as a deprecated compatibility surface.

### Header Utilities

The top bar carries live utilities that stay visible across routes:

* connection status
* language switcher
* CCS Bar link for the native macOS menu-bar companion
* docs link
* GitHub link
* privacy toggle
* theme toggle
* authenticated user menu when dashboard auth is enabled

### Global Dialogs

OAuth-driven flows can open project-selection and device-code dialogs above the
current page without changing your route.

## Current Route Map

| Group             | Label             | Route                       | Use it for                                                           |
| ----------------- | ----------------- | --------------------------- | -------------------------------------------------------------------- |
| General           | Home              | `/`                         | landing stats, live account monitor, logs handoff                    |
| General           | Analytics         | `/analytics`                | usage, cost, and session breakdowns                                  |
| Identity & Access | API Profiles      | `/providers`                | API and local-model profile CRUD                                     |
| Identity & Access | CLIProxy Overview | `/cliproxy`                 | OAuth providers, accounts, advanced variants, routing                |
| Identity & Access | AI Providers      | `/cliproxy/ai-providers`    | API-key and connector routes inside CLIProxy                         |
| Identity & Access | Control Panel     | `/cliproxy/control-panel`   | embedded upstream CLIProxy management center                         |
| Identity & Access | GitHub Copilot    | `/copilot`                  | copilot-api install, auth, and daemon status                         |
| Identity & Access | Cursor Provider   | `/cliproxy?provider=cursor` | current Cursor OAuth auth, accounts, and provider config flow        |
| Identity & Access | Accounts          | `/accounts`                 | CCS auth profiles and continuity lanes                               |
| Identity & Access | Shared Data       | `/shared`                   | shared commands, skills, and agents                                  |
| Compatible CLIs   | Claude Extension  | `/claude-extension`         | IDE bindings and apply/reset flows                                   |
| Compatible CLIs   | Codex CLI         | `/codex`                    | Codex diagnostics, control center, raw TOML                          |
| Compatible CLIs   | Factory Droid     | `/droid`                    | Droid diagnostics, quick controls, raw JSON                          |
| System            | Health            | `/health`                   | doctor-style system health and grouped checks                        |
| System            | Logs              | `/logs`                     | structured runtime telemetry and legacy errors                       |
| System            | Settings          | `/settings`                 | split-view CCS configuration workspace                               |
| Deprecated        | Cursor IDE Bridge | `/cursor`                   | legacy local Cursor daemon bridge; use only with `ccs legacy cursor` |
| Direct only       | Updates Center    | `/updates`                  | rollout inbox and support-matrix notices                             |

## Workspace Notes

### Home

The home route is an operational landing page:

* hero counters for profiles, CLIProxy, accounts, and health
* the live auth monitor with provider drill-down
* a dedicated handoff card that moves log inspection into `/logs`
* an embedded error-log monitor under the fold

### Identity And Access

This cluster mixes CCS-native profiles and proxy-driven providers:

* **API Profiles** is the CRUD workspace for settings-based profiles
* **CLIProxy Overview** is the OAuth and variant workspace
* **AI Providers** is the API-key and connector workspace inside CLIProxy
* **GitHub Copilot** remains a dedicated provider page
* **Cursor** now belongs to the CLIProxy provider set; the old Cursor IDE bridge is deprecated compatibility
* **Accounts** is the CCS auth-profile workspace
* **Shared Data** is the asset browser for commands, skills, and agents

That split matters: CCS auth profiles, API profiles, and CLIProxy provider
routes are adjacent in the UI, but they are not the same persistence model.

### Compatible CLIs

The compatible-CLI pages are dedicated control centers, not generic settings
forms:

* [Claude IDE Extension](/features/workflow/claude-extension)
* [Codex Adapter](/features/workflow/codex-adapter)
* [Droid Adapter](/features/workflow/droid-adapter)

### System

The System group now behaves like an operations cluster:

* **Health** mirrors `ccs doctor` status in a rich UI
* **Logs** is the dedicated log operations workspace
* **Settings** is the split-view configuration surface for global CCS config

## Where To Read Next

| If you want to understand...                 | Read this                                                    |
| -------------------------------------------- | ------------------------------------------------------------ |
| account-profile workflows and continuity     | [Accounts Workspace](/features/dashboard/accounts-workspace) |
| the split-view config surface                | [Settings Workspace](/features/dashboard/settings-workspace) |
| OAuth providers, variants, and routing       | [CLIProxy API](/features/proxy/cliproxy-api)                 |
| API-key and connector routes inside CLIProxy | [AI Providers Workspace](/features/proxy/ai-providers)       |
| live auth-state behavior                     | [Live Auth Monitor](/features/dashboard/live-auth-monitor)   |
| log inspection and retention controls        | [Dashboard Logs](/features/dashboard/logs)                   |
