本页保存的是公开项目资料快照，阅读过程不需要连接 GitHub。

Resetwatch

Know how much of each plan is left, and when it comes back. A plugin for Hermes Desktop.

Bars for what you still have, and the time it fills back up.

What you get

It shows what’s left. Live cards for Nous, Claude, Codex, Cursor, Kimi, Grok, GLM, DeepSeek, OpenCode Go, Ollama Cloud, MiniMax, Novita, DeepInfra, and AI Gateway when you are already signed in. Each card is one window: how full it is, how much is still there, and when it resets. No chat has to be open.

It names the plan. Claude shows Pro, Max, Max 5x, or Max 20x. Codex shows Plus. Cursor shows Ultra (or whatever the app is on). Kimi shows Advanced. GLM shows Lite, Pro, or Max. Nous Portal shows the portal plan, not a bare Plus.

It covers the rest by hand. Gemini, Perplexity, or anything you type. Paste the percent left and the reset time from the vendor page. Open takes you to that dashboard in the system browser.

It stays a page. Not a HUD, not a chip, not a side pane. Open it from the sidebar, the palette (“Resetwatch: Open”), or Ctrl/Cmd+Alt+R. Click a section name to fold it up. They start open, and they remember.

It does not scrape the web. Live rows come from Hermes OAuth plus the same CLI and app logins those vendors already use. No browser cookies. Nothing is sent off this machine except the same usage calls those apps already make for you.

What’s supported

Live cards fill on their own when that login is already on the machine:

• Nous Portal: Hermes
• Claude: Hermes OAuth, or Claude Code
• Codex: Hermes OAuth, or the Codex CLI
• OpenRouter: Hermes
• Cursor: Cursor app or cursor-agent
• Kimi: Kimi Code CLI, or KIMI_CODING_API_KEY / KIMI_API_KEY in Hermes env (Coding Plan)
• Grok: Grok CLI
• GLM: ZCode Coding Plan, or ZAI_API_KEY / GLM_API_KEY in Hermes env (includes peak / off-peak pricing)
• DeepSeek: DEEPSEEK_API_KEY in Hermes env (balance plus peak / off-peak)
• OpenCode Go: OPENCODE_GO_API_KEY in Hermes env (5h, weekly, monthly)
• Ollama Cloud: OLLAMA_API_KEY in Hermes env (5h / weekly; no exact reset time from the API)
• MiniMax: MINIMAX_API_KEY (or MINIMAX_CN_API_KEY) in Hermes env (Token Plan 5h / weekly)
• Novita: NOVITA_API_KEY in Hermes env (dollar balance)
• DeepInfra: DEEPINFRA_API_KEY in Hermes env (prepaid balance)
• AI Gateway: AI_GATEWAY_API_KEY in Hermes env (Vercel credits)

Gemini, Perplexity, and anything else can be a manual clock. Type the percent left and the reset time.

Want another live row? Open an issue. We can add it if that app or CLI already has a remaining-quota path we can read on your machine. We do not scrape vendor websites.

Install

Copy plugin.js and probe.py to $HERMES_HOME/desktop-plugins/resetwatch/ (%LOCALAPPDATA%\hermes on Windows, ~/.hermes on Mac). The desktop picks it up within seconds and hot-reloads on every save. If it does not appear, run “Reload desktop plugins” from the palette.

Live rows work on stock Hermes. probe.py asks the gateway Python for Claude, Codex, and OpenRouter. If Hermes OAuth is missing, it reads the Claude Code and Codex CLIs instead. Cursor, Kimi, Grok, GLM, DeepSeek, OpenCode Go, Ollama Cloud, MiniMax, Novita, DeepInfra, and AI Gateway come from those apps’ own CLI, desktop logins, or Hermes API keys. Copy both plugin.js and probe.py.

What’s inside

• A full /resetwatch page in the main workspace
• Sidebar row (watch icon)
• Palette command and mod+alt+r
• Live cards, polled every 5 minutes while the page is open. Probe also caches vendor API results for 5 minutes; Refresh bypasses that cache.
• Fold-up sections that start open
• Manual clocks stored in plugin-scoped ctx.storage

Where the numbers come from

Nous dollars and renewal time come from the gateway (usage.bars, then subscription.state if needed). If the gateway has account.usage, that RPC fills Claude, Codex, OpenRouter, and any other providers it already knows. On stock Hermes, probe.py fills the rest through shell.exec: the same Claude / Codex / OpenRouter fetchers. If Hermes OAuth is missing, Claude Code (~/.claude) and Codex CLI (~/.codex) fill those cards. Cursor (app or cursor-agent login), Kimi Code (~/.kimi-code), Grok CLI (~/.grok), and GLM via ZCode (~/.zcode) come from those logins first. If Kimi or GLM CLI login is missing, Hermes env keys fill the same cards: KIMI_CODING_API_KEY or KIMI_API_KEY (Coding Plan), and ZAI_API_KEY or GLM_API_KEY. DeepSeek, OpenCode Go, Ollama Cloud, MiniMax, Novita, DeepInfra, and AI Gateway use DEEPSEEK_API_KEY / OPENCODE_GO_API_KEY / OLLAMA_API_KEY / MINIMAX_API_KEY / NOVITA_API_KEY / DEEPINFRA_API_KEY / AI_GATEWAY_API_KEY from Hermes env (process env or $HERMES_HOME/.env on Windows and Mac). Older /usage output is still parsed when a session is focused, as a last fallback.

Manual clocks are whatever you typed. They do not refresh themselves.

How it reaches the gateway

Live data goes through the desktop plugin SDK (host.request JSON-RPC), plus probe.py through shell.exec when a signed-in CLI or app has quota the gateway does not expose. The page does not log into vendor sites. probe.py does not refresh Claude or Codex credentials. For Kimi and Grok it may refresh on 401 and write that vendor’s file back. Before writing it re-reads the file and merges token fields into that fresh record so concurrent CLI edits to other keys are kept. That protects the file; it does not make a shared refresh-token exchange safe if the CLI refreshes in the same window. It may also write a small cache under $HERMES_HOME/cache/resetwatch, including a 5-minute probe result cache so vendor APIs are not hit more often than that (Refresh passes --fresh to bypass; incomplete timed-out runs are not cached). Vendor fetches run in parallel with a time budget so one slow API cannot wipe every card. Tokens never go to stdout.

Contributing

Contributions are welcome. Open an issue first for anything bigger than a small fix so we can agree on the shape before you spend time on it.

License

MIT