tabby-tokendashboard
v0.2.0
Published
Shows remaining quota/balance of AI coding plans (Kimi Code, Volcengine ARK plans, DeepSeek) inside Tabby
Maintainers
Readme
tabby-tokendashboard
A Tabby plugin that shows the remaining quota/balance of your AI coding subscriptions right inside your terminal — a small floating pill over terminal tabs plus a full dashboard tab.
Supported plans:
| Plan | What is shown | Source |
|---|---|---|
| Kimi Code | Weekly quota, 5-hour rolling window, monthly quota, membership level | api.kimi.com/coding/v1/usages, using the local kimi CLI's OAuth credentials (auto-refreshed) |
| Volcengine ARK (Agent Plan / Coding Plan, personal & team) | Per-period usage (5h / session / weekly / monthly) with reset times | the locally installed arkcli CLI (arkcli usage plan) |
| DeepSeek | Total / granted / topped-up balance (CNY or USD) | official api.deepseek.com/user/balance with your own API key |
Features
- Floating mini-bar on terminal tabs:
D ¥58.0 · K 45% · A 77%(worst remaining quota per plan), click to open the dashboard - Dashboard tab with per-period progress bars, reset countdowns, balances, and manual refresh
- Desktop notification when any quota period drops below a configurable threshold (default 20%)
- Configurable poll interval (default 5 min), per-provider enable switches, overlay toggle
Install
From Tabby's plugin manager: Settings → Plugins → search tabby-tokendashboard → Install, then restart Tabby.
Manual: copy the package folder (containing package.json and dist/) into Tabby's plugin directory, then restart Tabby:
- Windows:
%APPDATA%\tabby\plugins\node_modules\tabby-tokendashboard - macOS/Linux:
~/.config/tabby/plugins/node_modules/tabby-tokendashboard
Prerequisites per provider
Each provider can be toggled independently; a provider whose prerequisites are missing simply shows an error/! state and does not affect the others.
- Kimi Code: install the Kimi Code CLI and log in once (
kimi login). The plugin reads~/.kimi-code/credentials/and refreshes the OAuth token automatically — no further setup. - ARK: install
@volcengine/ark-cliand log in (arkcli auth login volc-sso). Whatever plans your account is subscribed to are discovered automatically. - DeepSeek: create an API key at platform.deepseek.com and paste it into Settings → Token Dashboard.
Settings
Settings → Token Dashboard: DeepSeek API key, poll interval (minutes), low-quota alert threshold (%), per-provider toggles, overlay toggle.
Privacy
All queries run locally on your machine. Credentials never leave your computer: Kimi uses your local CLI token, ARK uses your local arkcli session, and the DeepSeek key is stored only in Tabby's own config file.
中文说明
在 Tabby 终端里实时显示 AI 编程订阅的剩余额度:Kimi Code(周配额 / 5 小时滚动窗口 / 月度总额)、火山方舟 Agent Plan / Coding Plan(各周期用量百分比和重置时间)、DeepSeek(账户余额)。
安装:Tabby 设置 → Plugins → 搜索 tabby-tokendashboard 安装并重启。
前置条件(按需启用,互不影响):
- Kimi Code:本机装好 kimi CLI 并登录过一次即可,插件自动续期凭证
- ARK:本机装好
arkcli并arkcli auth login volc-sso登录 - DeepSeek:在设置 → Token Dashboard 里粘贴你的 API key
所有查询都在本机进行,凭证不会离开你的电脑。
