Tokdash

English  |  中文  |  日本語  |  한국어  |  Español  |  Português

Local token & cost dashboard for AI coding tools

Try it without installing → tokdash.github.io/demo

[!NOTE] Multiple machines, one dashboard. Add the Tokdash instances running on WSL, a Mac, or any other box in Settings: every view combines whatever you select, the Servers tab compares the machines side by side, and the Quota tab keeps each provider's window bars and reset countdowns grouped per machine. Remote access → · quota tracking →

Also from the same author: Cosyncing. Synchronize and control your agents — from CLI to GUI, from desktop to phone. Cosyncing keeps your coding agents in sync across your own network.

Table of Contents

• Quick start
• One package, four views
  • WebUI
  • Terminal dashboard (TUI)
  • Companion status bar app
  • Statusline
• Install & run
• Features
• Quota tracking (optional)
• Cost accuracy note
• History retention
• Roadmap
• Contributing / security
• Documentation
• License

Quick start

pipx install tokdash
tokdash setup

That's it. tokdash setup detects the runtime, installs a managed one if needed, registers a local service, and prints the dashboard URL — http://127.0.0.1:55423. Full options, first-run notes, and updates live in Install & run; prefer to look around first? The live demo runs on the real UI.

One package, four views

One local package, one local data index — and four ways to read it. Every surface parses the same session logs on your own machine, so the browser dashboard, the terminal, the menu bar, and your agent's statusline always agree.

View	What it is	Reach for it when
WebUI	The full dashboard: Overview, Sessions, Stats, Report, Quota, Servers	You want the whole picture, charts, and drill-down
TUI	tokdash tui — Overview, Report and Quota in the terminal	You live in the terminal and want the numbers without a browser
Companion	Native menu-bar (macOS) / notification-area (Windows) app	You want today's spend and quota visible all day, dashboard closed
Statusline	A live token/cost item inside your agent's statusline	You want the cost ticker exactly where you type

WebUI

The dashboard is a single page served by the local FastAPI app: exact input / cache / output token breakdowns, per-tool and per-model tables, a contribution heatmap, a week/month/year Report, per-provider Quota windows with reset countdowns, and a Servers tab that combines and compares several machines. Click any screenshot to open the live demo.