Skip to content
This repository was archived by the owner on May 20, 2026. It is now read-only.

dashboard.md

Latest commit

 

History

History
94 lines (66 loc) · 3.62 KB

dashboard.md

File metadata and controls

94 lines (66 loc) · 3.62 KB

Web Dashboard

Causantic includes a web dashboard for visually exploring your memory graph, clusters, and search results.

Quick Start

npx causantic dashboard

Opens at http://localhost:3333. Use --port to change:

npx causantic dashboard --port 8080

Pages

Overview

Collection-wide statistics at a glance:

  • Total chunks, edges, and clusters
  • Graph connectivity metrics
  • Per-project breakdown
  • Recent ingestion activity
  • Retrieval analytics (shown when feedback data exists): tool call frequency chart, retrieval volume over time, chunk size distribution, top retrieved chunks table, and summary stat cards (total retrievals, unique queries, top tool)

Search

Interactive query interface:

  • Type a query and see retrieval results in real time
  • Results show source attribution (vector, keyword, cluster, graph)
  • View matching chunks with relevance scores
  • Filter by project

Timeline

D3.js swimlane visualization of session history:

  • Swimlane layout grouped by project
  • Chain walking visualization between chunks
  • Click chunks to see content
  • Zoom and pan across session timeline

Clusters

Browse HDBSCAN topic clusters:

  • Cluster list with member counts and labels
  • Click a cluster to see member chunks
  • View cluster centroids and quality metrics
  • Noise ratio and coverage statistics

Projects

Per-project views:

  • Sessions per project with time ranges
  • Chunk distribution across sessions
  • Retrieval counts and unique query counts per project
  • Project-specific graph statistics

API Routes

The dashboard exposes a REST API that powers the UI. These routes can also be used programmatically:

Route Description
GET /api/stats Collection statistics and retrieval analytics
GET /api/chunks List chunks with pagination
GET /api/edges List edges with filtering
GET /api/clusters List clusters with member counts
GET /api/projects List projects with chunk and retrieval counts
GET /api/graph Graph data for visualization (nodes + edges)
GET /api/graph/neighborhood Neighborhood subgraph around a specific chunk
GET /api/search?q=<query> Search memory with retrieval pipeline
GET /api/search/suggestions Search query suggestions
GET /api/sessions?project=<slug> List sessions for a project
GET /api/timeline Timeline data for swimlane visualization
GET /api/chain/walk Walk a chain from a given chunk
GET /api/benchmark-collection Run benchmark and return results
GET /api/benchmark-collection/history Historical benchmark results

Architecture

The dashboard is a single-page React application served by an Express backend:

  • Backend: Express server in src/dashboard/server.ts with API routes in src/dashboard/routes/
  • Frontend: React + Vite in src/dashboard/client/ with D3.js for graph visualization
  • Data: Reads directly from the SQLite/LanceDB stores — no separate database

The dashboard is read-only and does not modify any data.