What the Dashboard Shows
The Geneclaw dashboard is a local, read-only visualization interface that reads directly from your data/events.jsonl event store and benchmarks/ directory. It provides:
Event Stream View
A real-time view of all events in the event store, filterable by type (observe, diagnose, propose, gate, apply), date range, and agent. Color-coded log levels make it easy to spot gate rejections, apply failures, and rollback events at a glance.
Evolution Cycle Tracker
A timeline view of all evolution cycles, showing each proposal's journey from generation through gating to application or rejection. For each proposal you can see:
- The full unified diff (with syntax highlighting)
- The risk score and its contributing factors
- The gate layer that passed or rejected it
- The test results from the pytest gate
- The final apply status (applied / rejected / pending / rolled back)
Benchmark Trends
A chart comparing benchmark results across evolution cycles. Tracks key agent performance metrics over time so you can verify that each applied GEP is actually improving performance — not just passing tests.
Gate Decision Audit
A searchable, sortable table of all Gatekeeper decisions. Essential for compliance and post-incident analysis. Every gate rejection includes the reason and the specific layer that rejected it.
How to Run the Dashboard
# Start the local dashboard server (read-only)
geneclaw dashboard
# Opens http://localhost:7891 by default
# Custom port
geneclaw dashboard --port 8080
# Point to a specific event store
geneclaw dashboard --events-path /path/to/events.jsonl
Privacy & Security
The dashboard never sends data to any external service. It reads your local events.jsonl and renders everything client-side. Secrets are redacted in the event store before they reach the dashboard. No cloud, no telemetry.
Dashboard Roadmap
Future dashboard capabilities under consideration (not yet implemented):
- In-browser proposal review and one-click approval (still requires CLI
--apply) - Diff viewer with inline commenting
- Export reports to PDF/Markdown
- Multi-agent aggregated view