Admin Dashboard
The ContextForge dashboard is a Starlette ASGI app that renders GridViewSpec pages for ContextUnity observability. It reads Brain data through Brain Admin gRPC and stores dashboard-local agent records/preferences in local SQLite stores.
Dashboard Views
| View | URL | Description |
|---|---|---|
| Overview | / | KPIs, service status, trace volume, memory summaries |
| Traces | /traces/ | Searchable list of agent execution traces |
| Trace Detail | /traces/{trace_id}/ | Step-by-step trace inspection |
| Agents | /agents/ | Dashboard-local agent record list |
| Agent Detail | /agents/{pk}/ | Agent metadata, activity, and related traces |
| Agent Hierarchy | /agents/hierarchy/ | Agent relationship view |
| Events | /events/ | Event search |
| Memory | /memory/ | Memory layer statistics |
| Memory Events | /memory/events/ | Episodic event search |
Data Flow
Browser -> Starlette dashboard routes -> GridViewSpec page builders -> BrainAdminClient gRPC wrappers -> ContextBrain Admin RPCs
Forge local SQLite: - AgentStore records - Grid preferencesKPI Dashboard
The overview page displays:
- Trace volume from Brain Admin trace search and analytics summaries.
- Error rates from trace status and analytics summaries.
- Service health from Forge probes and configured service endpoints.
- Memory statistics from Brain Admin memory layer stats.
- Request/error charts from
/api/chart-data/.
Time range is selectable with dashboard query parameters such as ?range=24h|7d|30d.
Trace Inspector
The trace detail view provides:
- Step timeline with graph node spans.
- Tool calls, arguments, and results.
- Token usage and cost estimates where available.
- Security and provenance badges.
- Langfuse link metadata when configured.
Agent Views
Forge agent pages are dashboard-local operational metadata. Router graph behavior remains manifest-driven; Forge does not act as Router’s permission source.