# TokenTracker — Local Cost Dashboard for 13+ AI CLIs

> TokenTracker collects token usage across 13+ AI coding tools and serves a local dashboard for cost trends, model breakdowns, and integration health.

## Install

Copy the content below into your project:

## Quick Use

```bash
npx tokentracker-cli
# dashboard: http://localhost:7680
npm i -g tokentracker-cli
tokentracker status
tokentracker doctor
```

## Intro

TokenTracker collects token usage across 13+ AI coding tools and serves a local dashboard for cost trends, model breakdowns, and integration health.

**Best for:** tracking spend and rate limits across multiple agent tools

**Works with:** Node.js 20+, Claude Code/Codex CLI/Cursor/Gemini CLI/OpenCode and more

**Setup time:** 3-10 minutes

### Key facts (verified)

- GitHub: 449 stars · 40 forks · pushed 2026-05-13.
- License: MIT · owner avatar + repo URL verified via GitHub API.
- README-verified entrypoint: `npm i -g tokentracker-cli`.

## Main

- Start with `npx tokentracker-cli` for a zero-config first run; it installs the needed hooks and opens the dashboard on `localhost:7680`.

- Use `tokentracker status` after upgrades to confirm each tool integration is active (hooks, plugins, or passive readers depending on the tool).

- Keep your workflow auditable: TokenTracker focuses on token counts and timestamps (not prompt/response content) per its README privacy section.

### Source-backed notes

- README says first run opens the dashboard at `http://localhost:7680` and supports global install via `npm i -g tokentracker-cli`.
- README lists `tokentracker sync`, `status`, and `doctor` commands for maintenance and troubleshooting.
- README enumerates supported tools and describes detection methods (hooks/plugins/passive readers).

### FAQ

- **Is it local-only?**: README states data stays on your machine by default; leaderboard is optional/opt-in.
- **Which Node version do I need?**: README lists Node.js 20+ as the requirement.
- **How do I verify integrations?**: Run `tokentracker status` or `tokentracker doctor` per README.

## Source & Thanks

> Source: https://github.com/mm7894215/TokenTracker
> License: MIT
> GitHub stars: 449 · forks: 40

---

<!-- ZH -->

## Quick Use

```bash
npx tokentracker-cli
# dashboard: http://localhost:7680
npm i -g tokentracker-cli
tokentracker status
tokentracker doctor
```

## Intro

TokenTracker 本地运行，汇总 13+ AI 编码工具的 token 使用数据，并提供 localhost 看板用于成本趋势/模型拆解/集成健康；README 说明首次运行会自动装好 hooks，数据默认不出本机。

**Best for:** 多工具并行使用、想统一控费与限额的人

**Works with:** Node.js 20+；Claude Code/Codex CLI/Cursor/Gemini CLI/OpenCode 等

**Setup time:** 3-10 minutes

### Key facts (verified)

- GitHub：449 stars · 40 forks；最近更新 2026-05-13。
- 许可证：MIT；作者头像与仓库链接均已通过 GitHub API 复核。
- README 中核对过的入口命令：`npm i -g tokentracker-cli`。

## Main

- 首次体验用 `npx tokentracker-cli`：README 表示它会自动装好钩子并打开 `localhost:7680` 看板。

- 工具升级后用 `tokentracker status` 复核每个集成是否生效（不同工具对应 hook/plugin/passive reader）。

- 把可审计放前面：README 的隐私说明强调只收集 token 与时间戳，不上传提示词/回复内容。

### Source-backed notes

- README 说明首次运行会打开 `http://localhost:7680`，并可用 `npm i -g tokentracker-cli` 全局安装。
- README 列出 `tokentracker sync/status/doctor` 等维护与排障命令。
- README 给出支持的工具清单，并解释 hook/plugin/passive reader 的集成方式。

### FAQ

- **数据会上传吗？**：README 表示默认完全本地；排行榜为可选/自愿开启。
- **需要什么 Node 版本？**：README 要求 Node.js 20+。
- **怎么检查集成是否正常？**：按 README 用 `tokentracker status` 或 `tokentracker doctor`。

## Source & Thanks

> Source: https://github.com/mm7894215/TokenTracker
> License: MIT
> GitHub stars: 449 · forks: 40


---
Source: https://tokrepo.com/en/workflows/tokentracker-local-cost-dashboard-for-13-ai-clis
Author: Script Depot