Analytics and cost tracking
Ironspire tracks token usage and costs in real time across all providers. You can monitor spending per agent, explore historical trends, detect anomalies, and export data for offline analysis.
The Session HUD
At the top of every chat panel, the Session HUD shows live metrics for the current conversation:
- Model: which model is active (with per-agent overrides noted)
- Cost: cumulative USD spent this session
- Context bar: how much of the model's context window is in use
The context bar turns red at 70% usage and pulses at 90%+, so you know when a conversation is approaching its limit.
If you are on CLI mode with a Claude subscription, a Usage bar also appears showing your five-hour utilisation window and time until reset.
The Analytics panel
Click Analytics in the sidebar to open the dashboard. It contains seven tabs, each with a dedicated view of your fleet's activity.
Filter bar
A shared DashboardFilterBar sits at the top of every tab. It provides:
- Agent filter: scope data to a single agent or view all agents
- Provider filter: narrow by provider group (Claude, OpenAI, Google, etc.)
- Period selector: Session, 1h, 6h, 24h, 7d, 30d, 90d, or a custom date range
- CSV export: download raw turn data or a summary spreadsheet for the selected period
Historical periods (24h and above) read from the SQLite cost database. The Session and short periods use live in-memory data.
Overview
Aggregate KPIs at a glance:
| Metric | What it shows |
|---|---|
| Total Spend | Cumulative cost for the selected period (USD) |
| Active Agents | Number of agents currently running |
| Total Tokens | Combined input and output tokens |
| Cache Hit Rate | Percentage of input tokens served from cache |
| Burn Rate | Current spend rate in USD per hour |
| Turns | Total conversation turns in the period |
Fleet
A per-agent status grid showing each agent's health, model, provider, session cost, token counts and uptime. Use this tab to compare workload distribution and spot under-utilised agents.
Costs
Historical cost analytics powered by Recharts time-series charts:
- Spend over time: area chart of cost by agent or provider, with downsampling at 200+ data points
- Anomaly detection: z-score analysis flags unusual spend (1.5 sigma = warning, 2.5 sigma = critical). A red pulse dot appears on the Costs tab when anomalies are active.
- Burn rate forecast: daily extrapolation based on current session spend rate
- Per-agent breakdown: sortable table of session cost, cumulative cost and trend sparklines
Performance
Operational efficiency metrics:
- Latency (time to first token, average response time)
- Throughput (tokens per second)
- Token efficiency ratios (output vs input)
Communication
Relay message analytics for agent-to-agent collaboration:
- Inter-agent message volume and routing patterns
- Relay throughput and latency
- Message type distribution
Intelligence (Forge)
Cost optimisation recommendations:
| Feature | Description |
|---|---|
| Model suggestions | Identifies where a cheaper model (e.g. Sonnet instead of Opus) could handle the same task, with estimated savings |
| Task-type cost profiling | Breaks spend into categories: research, coding, testing, review |
| Session efficiency scoring | Composite score weighted 40% cache utilisation, 35% cost efficiency, 25% context usage |
| Workload rebalancing | Suggests redistributing tasks across agents with projected savings |
Insights (Forge)
Advanced analytics with a yellow bloom indicator. A red badge appears on this tab when active anomalies need attention. See pricing for details on what Forge includes.
Budget alerts
You can set a daily spending limit:
- Open Settings (
Ctrl+,) - Go to the Operations tab
- Under Limits, toggle on the daily budget alert and enter a dollar amount
When your spending crosses the threshold, a warning banner appears in the Analytics panel.
Data persistence
Cost and usage data is stored in a per-profile SQLite database using WAL mode for performance. This means historical data survives app restarts and is scoped to your active profile. The database lives in your user data directory alongside other local state.
Resetting costs
Click the Reset button in the Analytics panel header to zero out session cost counters. Historical data in the SQLite database is preserved.