Licence
MIT
Version
0.7.6
Deps
10
Size
945 kB
Vulns
0
Weekly
3.8K
@gajae-code/stats
Local observability dashboard for AI usage statistics.
Features
- Session log parsing: Reads JSONL session logs from
~/.gjc/agent/sessions/ - SQLite aggregation: Efficient stats storage and querying using
bun:sqlite - Web dashboard: Real-time metrics visualization with Chart.js
- Incremental sync: Only processes new/modified log entries
Metrics Tracked
| Metric | Calculation |
|---|---|
| Tokens/s | output_tokens / (duration / 1000) |
| Cache Rate | cache_read / (input + cache_read) * 100 |
| Error Rate | count(stopReason=error) / total_calls * 100 |
| Total Cost | Sum of usage.cost.total |
| Avg Latency | Mean of duration |
| TTFT | Mean of ttft (time to first token) |
Usage
Via CLI
# Start dashboard server (default: http://localhost:3847)
gjc stats
# Custom port
gjc stats --port 8080
# Print summary to console
gjc stats --summary
# Output as JSON (for scripting)
gjc stats --jsonProgrammatic
import { getDashboardStats, syncAllSessions } from "@gajae-code/stats";
// Sync session logs to database
const { processed, files } = await syncAllSessions();
// Get aggregated stats
const stats = await getDashboardStats();
console.log(stats.overall.totalCost);
console.log(stats.byModel[0].avgTokensPerSecond);API Endpoints
| Endpoint | Description |
|---|---|
GET /api/stats |
Overall stats with all breakdowns |
GET /api/stats/models |
Per-model statistics |
GET /api/stats/folders |
Per-folder/project statistics |
GET /api/stats/timeseries |
Hourly time series data |
GET /api/sync |
Trigger sync and return counts |
Data Storage
- Session logs:
~/.gjc/agent/sessions/(JSONL files) - Stats database:
~/.gjc/stats.db(SQLite)
Dashboard
The web dashboard provides:
- Overall metrics cards (requests, cost, cache rate, error rate, duration, tokens/s)
- Time series chart showing requests and errors over time
- Per-model breakdown table
- Per-folder breakdown table
- Auto-refresh every 30 seconds
License
MIT