Skip to main content

Governance Dashboard

The TealTiger Governance Dashboard provides real-time visibility into everything your governance layer does. See which agents are running, what they’re spending, what’s being blocked, and why.

What It Is

A local-first web application that visualizes governance data collected by TealTiger. No cloud dependency — your governance data stays on your infrastructure.
  • Real-time: Live updates via WebSocket for cost velocity, decisions, and alerts
  • Searchable: Full-text search across the audit trail
  • Filterable: Slice data by agent, role, action type, time range, and more
  • Inspectable: Drill into any governance decision to see the full TEEC evidence envelope
  • Configurable: Adjust budgets, thresholds, and policies from the UI

Architecture

Dashboard component architecture

Panels

Overview

Top-level metrics at a glance:
  • Active agents count
  • Total cost (24h)
  • Decision breakdown (allow/deny/sanitize/report)
  • Recent governance events stream
  • Burn rate sparkline

Agents

Role-based agent matrix showing all active and frozen agents with per-agent stats. See Agent Matrix for details.

Costs

Cost velocity, budget forecasting, and optimization suggestions. See Costs Panel for details.

Policies

Visual policy editor with:
  • Form-based policy creation (no JSON editing)
  • Real-time validation
  • Policy simulation (“what would happen?”)
  • Import/export for version control
  • Deploy with hot-swap (no restart)

Audit Trail

Chronological event log with filtering and search. See Audit Trail for details.

Evidence Viewer

Deep-dive into any governance decision — full TEEC envelope, reason chains, confidence scores, cryptographic seals. See Evidence Viewer for details.

Decision Explorer

Table and timeline views of governance decisions with drill-down. See Decision Explorer for details.

Settings

Configuration panels for:
  • Budget management (session, daily, monthly)
  • Velocity alert thresholds
  • Model routing configuration
  • Canary management
  • Role definitions

The sidebar organizes panels into sections:

Data Flow

  1. SDK writes: TealTiger SDK (via observe/TealGuard) writes governance events to the SQLite database
  2. API reads: Dashboard API reads from the same database and serves via REST + WebSocket
  3. Frontend displays: Next.js frontend fetches data, renders panels, and subscribes to real-time updates
The dashboard is read-only by default — it doesn’t affect your running agents unless you explicitly use the Settings panel to adjust budgets or policies (which propagates via hot-swap).

Requirements

  • Node.js 18+
  • npm or yarn
  • SQLite (bundled with the API via better-sqlite3)
No Docker, no cloud services, no external databases.

Quick Start

See Getting Started for the full setup guide.