Skip to content
TTDash

Understand every token.

TTDash turns local toktrack usage data into clear cost, request, cache, model, and provider insights—without sending your data to a hosted TTDash backend.
Get startedView on GitHub
Latest stable  v6.3.14

Local-first by design

Usage data, settings, and backups stay on the machine running TTDash. There is no hosted TTDash account, database, analytics, or tracking.

Analysis that stays useful

Explore costs, tokens, requests, cache efficiency, forecasts, anomalies, limits, model mix, and provider concentration.

Fast paths for real workflows

Import directly from toktrack, upload JSON, filter and drill down, then export the exact view as CSV or a localized PDF.

TTDash dashboard showing usage metrics, cost charts, and provider analysis
Your local usage data, from headline metrics to detailed trends.

Start in minutes

Section titled “Start in minutes”

Run the latest release without installing it globally:

Terminal window
npx --yes @roastcodes/ttdash@latest

TTDash opens a local, authenticated dashboard. Choose Auto import in the first-run view to collect compatible toktrack data, or upload a JSON export yourself.

Install and runRequirements, package runners, first launch, and local authentication.
Import usage dataAuto-import, JSON replacement uploads, and conservative backup merges.
Configure deploymentCLI flags, storage paths, remote access, security, and Docker.
Automate with the APIAuthentication, JSON endpoints, error rules, and Server-Sent Events.

Privacy without surprises

Section titled “Privacy without surprises”

TTDash serves the app and API from your own process. It contacts the npm registry only when it needs the pinned toktrack package or checks the latest toktrack version. Remote access is opt-in and always requires authentication.

Before exposing TTDash beyond loopback, read Remote access and security and the repository’s security policy.