- Cài 1 npm package, daemon tự sync mỗi 5 phút, xem token tiêu thụ theo device/tool/model/project.
- Self-host Docker Compose, 6 OAuth provider, leaderboard cộng đồng, MIT license.
TL;DR
TokenArena là nền tảng open-source theo dõi token usage của các local AI coding CLI. Cài npm package @poco-ai/tokenarena, chạy tokenarena init, daemon tự đồng bộ data mỗi 5 phút lên web dashboard. Bạn xem được project nào đốt nhiều token nhất, tỉ lệ input/output, breakdown theo device/tool/model. Stack Next.js + PostgreSQL + Prisma, self-host Docker Compose trong vài phút, MIT license, 92 stars trên GitHub.
Có gì mới
Đây là một cách tiếp cận khá "đúng timing" khi ngày càng nhiều dev dùng song song nhiều AI CLI: Claude Code chạy feature, Codex chạy review, Gemini CLI chạy doc — và không ai thực sự biết tool nào đang ngốn nhiều token nhất. TokenArena giải quyết đúng pain point đó: collect data tự động từ các CLI ở máy local, đẩy lên dashboard, rồi nhóm theo device, tool, model, hoặc project.
Khác với các usage dashboard built-in của từng provider (mỗi nơi một UI, mỗi nơi một định dạng), TokenArena là lớp thống nhất: 1 dashboard cho tất cả. Và vì nó self-host, data của bạn không phải gửi ra SaaS bên thứ ba.
Điểm tinh tế là cách project tiếp cận cộng đồng: vừa giữ privacy mặc định (hash tên project), vừa cho phép opt-in lên leaderboard + share badge. Bạn được cả hai — dữ liệu riêng tư cho team nội bộ, social proof công khai khi muốn khoe.
Tại sao đáng chú ý
Ba lý do:
- Khả năng self-host dễ — Docker Compose +
start.sh, không cần DevOps cao cấp. - Privacy-first — tên project mặc định hash anonymous, bạn không lộ tên client lên leaderboard public.
- Community loop — có follow user, badge chia sẻ (usage, forecast, heatmap), leaderboard — biến monitoring thành trò chơi nhẹ nhàng.
Với team nội bộ, đây là cách rẻ nhất (free) để biết nhân viên đang "đốt" token ở đâu mà không phải xây dashboard riêng.
Technical facts
| Layer | Tech |
|---|---|
| CLI | TypeScript + Commander |
| Web | Next.js (App Router) + React + shadcn/ui |
| Database | PostgreSQL + Prisma |
| Auth | better-auth (Discord, GitHub, GitLab, Google, Linux.do, Watcha) |
| Build | pnpm monorepo |
| Deploy | Docker Compose |
Commands chính:
npm install -g @poco-ai/tokenarena
tokenarena init # nhập API key
tokenarena sync # upload thủ công
tokenarena daemon # auto-sync mỗi 5 phút
tokenarena service setup # chạy như systemd/launchdMetrics thu được mỗi session: total tokens, input, output, reasoning tokens, cache hits, active duration, session count, message count — đủ sâu để phân tích prompt nào inefficient (input/output ratio lệch bất thường).
So sánh với Tokscale
Tokscale là tool tương tự, list rõ support cho Claude Code, Codex, Gemini, Cursor, OpenCode, AmpCode, Kimi, v.v., tập trung mạnh vào global leaderboard + contribution graph 2D/3D kiểu GitHub.
| Aspect | TokenArena | Tokscale |
|---|---|---|
| Self-host | Docker Compose, PostgreSQL | SaaS-first |
| Breakdown | Device / tool / model / project | Tool + thời gian |
| Visualization đặc trưng | Multi-dim charts, badge share | Contribution graph 2D/3D |
| OAuth providers | 6 (gồm Linux.do, Watcha) | Ít hơn, focus GitHub |
| Danh sách CLI support | Chưa list rõ | List chi tiết |
Chọn TokenArena nếu bạn cần self-host và breakdown đa chiều. Chọn Tokscale nếu muốn leaderboard global ngay không phải deploy.
Use cases thực tế
- Solo dev: phát hiện project cá nhân nào đang đốt token vô ích (lặp lại prompt dài, context window dư thừa).
- Team engineering: self-host nội bộ → xem nhân viên/team nào tiêu nhiều token nhất, tool nào ROI tốt.
- Indie hacker: embed badge usage vào README của side-project để khoe stats thật.
- Prompt optimizer: theo dõi input/output ratio — ratio càng lệch về input, prompt càng "béo" vô ích, cần tối ưu.
- Cost attribution: khi tính chi phí theo project/client, breakdown theo project giúp báo cáo rõ ràng hơn thay vì gộp chung một bill API.
- Reasoning token audit: model reasoning (o-series, thinking mode) có thể đốt gấp 5-10 lần output tokens — metric reasoning tokens riêng giúp phát hiện task dùng reasoning mode không cần thiết.
Limitations & pricing
- Pricing: 100% free, MIT license. Hosted version tại
token.poco-ai.comcũng free. - Chỉ đếm token, chưa convert ra USD — bạn tự map giá theo model.
- README chưa list cụ thể từng AI CLI được support — phải đọc source hoặc test.
- Repo còn early-stage (92 stars, 13 forks) — có thể có breaking changes.
- Chưa có mobile app, chỉ web dashboard.
Điều đáng theo dõi
Nếu maintainer bổ sung cost tracking USD tự động theo giá từng model và list chính thức các CLI được support, TokenArena sẽ là lựa chọn self-host tốt nhất cho team muốn kiểm soát AI spend mà không khoá vào SaaS. Hiện tại bản GitHub đã đủ dùng cho cá nhân và team nhỏ.
Nguồn: github.com/poco-ai/TokenArena, token.poco-ai.com, @QingQ77 trên X.
