Visual Audit Dashboard

A read-only visualization interface built directly on your events.jsonl and benchmarks/ data. No secrets, no cloud sync — everything stays local.

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

Local-only, read-only

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