Ttdash

TTDash

[](https://github.com/roastcodes/ttdash/actions/workflows/ci.yml) [](https://roastcodes.github.io/ttdash/) [](https://www.npmjs.com/package/@roastcodes/ttdash) [](LICENSE) [](package.json)

TTDash is a local-first dashboard and CLI for [`toktrack`](https://github.com/mag123c/toktrack) usage data. Explore costs, tokens, requests, models, providers, forecasts, and exports without sending your usage data to a hosted TTDash backend.

[](https://roastcodes.github.io/ttdash/guides/dashboard/)

Quick start

Run the latest release without a global installation:

npx --yes @roastcodes/ttdash@latest

Or use Bun:

bunx @roastcodes/ttdash@latest

TTDash starts on `http://127.0.0.1:3000`, selects a nearby free port when necessary, and opens your browser. You can then auto-import current `toktrack` data, upload supported JSON, or restore a TTDash usage backup.

For a global installation:

npm install --global @roastcodes/ttdash
ttdash

What you get

• Cost, token, request, cache, model, provider, weekday, and calendar analysis
• Daily, monthly, yearly, preset, and custom date filters
• Forecasts, comparisons, anomalies, cache ROI, limits, and concentration insights
• toktrack and legacy daily JSON imports plus TTDash backup restore
• Host-based system exports, multi-file imports, and combined cross-system cost views
• CSV export and localized PDF reports when Typst is installed
• Local-first storage, configurable dashboards, themes, keyboard navigation, an