fcd7ff4f84
- Extracted directory path utilities from multiple packages into a centralized '@oh-my-pi/pi-utils/dirs' module. - Moved 30+ path helper functions (getAgentDir, getConfigRootDir, getPluginsDir, getMCPConfigPath, etc.) from scattered locations into a single shared utility module. - Consolidated APP_NAME, CONFIG_DIR_NAME, and VERSION constants into the centralized dirs module for reuse across packages. - Updated 70+ import statements across packages/ai, packages/coding-agent, packages/stats, and packages/tui to use the new centralized module. - Removed local path construction logic and replaced with utility function calls for improved maintainability and consistency. - Deleted packages/coding-agent/src/extensibility/plugins/paths.ts as its functions were moved to the centralized dirs module.
@oh-my-pi/omp-stats
Local observability dashboard for AI usage statistics.
Features
- Session log parsing: Reads JSONL session logs from
~/.omp/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)
omp stats
# Custom port
omp stats --port 8080
# Print summary to console
omp stats --summary
# Output as JSON (for scripting)
omp stats --json
Programmatic
import { getDashboardStats, syncAllSessions } from "@oh-my-pi/omp-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:
~/.omp/agent/sessions/(JSONL files) - Stats database:
~/.omp/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