Dashboard

Squeezr includes a built-in web dashboard that provides real-time visibility into compression activity, project stats, rate limits, and configuration. No extra installation needed — it's served directly by the proxy.

Accessing the dashboard

Open your browser and navigate to:

http://localhost:8080/squeezr/dashboard

The dashboard is available whenever the proxy is running. It uses Server-Sent Events (SSE) via the /squeezr/events endpoint to update in real time.

Pages

The dashboard has five pages, accessible from the sidebar navigation:

Overview

The landing page shows a high-level summary of your current session: total requests proxied, tokens saved, compression ratio, cost saved, per-tool breakdown, sparkline chart, context pressure bars, active project badge, and savings breakdown (deterministic, AI, dedup, system prompt, overhead).

Additionally, the overview displays resilience indicators:

• Compression latency — p50/p95 in milliseconds per request, with sample count and average.
• Expand rate — percentage of compressions where the model requested the original content back. Color-coded: green (<10%), yellow (10-25%), red (>25%). High expand rate means compression is too aggressive.
• Circuit breaker indicator — in the sidebar, shows whether the AI compression backend is healthy (green), probing (yellow), or down (red).
• Bypass toggle — in the sidebar, click to instantly disable all compression without restart. The toggle stays synced via SSE.

Projects

Lists all projects Squeezr has seen, with per-project compression stats. Each project is auto-detected from the working directory of incoming requests. Click a project to see its detailed history and per-tool breakdown.

History

A paginated log of all compressed requests with timestamps, tool names, original size, compressed size, compression ratio, and which pipeline layers were applied. Useful for debugging why a specific request was or wasn't compressed.

Limits

Displays rate limit status for each configured provider (Anthropic, Google, OpenAI, etc.). Shows remaining requests, token budgets, and when limits reset. Helps you understand when you're approaching provider rate limits.

Settings

View and modify Squeezr configuration without editing TOML files. Changes are saved to squeezr.toml and take effect immediately. Includes toggles for compression mode, AI fallback, threshold, skip/only tools, and more.

CLI shortcut

You can also open the dashboard from the terminal:

squeezr status

The squeezr status output includes the dashboard URL for quick access.