Skip to content

Dashboard

scarecr0w12 edited this page Jun 18, 2026 · 2 revisions

Dashboard

The CortexPrism Web UI features a configurable dashboard with drag-and-drop widgets, providing system overview and monitoring at a glance. It is the default landing page when opening the Web UI.

Dashboard Widgets

Widget Size Description
KPI Cards 4×1 Agent turns, sessions, tokens, cost
Server Info 2×1 Uptime, LLM provider/model, Cortex version, system status
Daemon Status 2×2 Validator, executor, scheduler detail cards with status dots, online count, warning banner
Memory Stats 2×1 Episodic, semantic, reflection, graph counts
System Resources 2×2 Memory/disk bars, CPU cores, platform panel
Recent Sessions 2×2 Latest session list with agent, model, timestamps
Token Chart 2×2 Token usage over time (Chart.js stacked bar)
Recent Activity 2×2 Latest events from Cortex Lens audit log

Layout Configuration

Widget layout is persisted to ~/.cortex/dashboard.json and managed via:

  • Drag and drop — Reposition widgets in edit mode (swap positions in array)
  • Add/Remove — Toggle widgets from the widget picker panel
  • Resize — Some widgets span 1 or 2 columns/rows

Default layout: 8 widgets (KPI Cards, Server Info, Daemon Status 2-row, Memory Stats, System Resources 2-row, Recent Sessions 2-row, Token Chart, Recent Activity).

Custom HTML Widgets

Agents can craft fully custom dashboard widgets via the dashboard_manage tool:

  • Arbitrary HTML and inline CSS
  • Optional title override
  • Configurable refresh interval (minimum 5 seconds)
  • Script tags and event handlers stripped for safety
  • Hidden from the manual UI widget picker (agent-only creation)

REST API

Method Path Description
GET /api/dashboard/config Get widget layout
PUT /api/dashboard/config Update widget layout

Agent Tool

The dashboard_manage tool lets agents manipulate the dashboard directly:

dashboard_manage list                          # List current widgets
dashboard_manage add --type html --html "..."   # Add custom HTML widget
dashboard_manage remove --id widget-123         # Remove a widget
dashboard_manage update --id widget-123 --html "..."  # Update widget content

Navigation

The Dashboard is the default landing page when opening the Web UI. It appears in the "Core" navigation section with active-state highlighting. The Command Palette (Ctrl+K) also references it.

See Also

Clone this wiki locally