AI Token ViewerSupport
Start with the on-key message and your connection settings.
What does the percentage mean?
The remaining portion of the reported subscription window: 100 minus usage, clamped to 0–100 and rounded down. This is not a count of remaining tokens.
Why does Claude say “Not supported” on the third view?
The Claude status-line bridge does not provide a credit balance. Only Codex balances reported by its service are shown. This is not a connection failure.
Why does the key show --?
The selected window or balance is unavailable, or the previous window has passed its reset time. The plugin waits for fresh data instead of assuming a full quota.
Why is Claude data old?
The bridge receives quota information with Claude responses. The plugin checks the saved file every 30 seconds, but cannot obtain a new server value while Claude is inactive. Check bridge setup and use Claude normally.
Codex is not found or login fails
Run codex login with ChatGPT. In the settings panel, set the absolute path to the native codex.exe if needed. A .cmd or .bat launcher is not supported. Restart Stream Deck after changing PATH.
Why does another long press do nothing?
Manual refresh is limited to once every 10 seconds from the last fetch start. Buttons using the same connection share this interval. Short presses still change the displayed view.
How do I keep my existing Claude status line?
The setup helper leaves an existing status line untouched. Use the wrapper example in the bundled help to forward the same JSON to both scripts, or intentionally replace it with --replace after backup.
How do I remove the integration?
Uninstall the plugin in Stream Deck. Restore Claude’s previous statusLine setting from backup, then remove the bridge and usage JSON from your .ai-token-viewer home folder if no longer needed.
What should I include in a support request?
Plugin version, Windows version, Stream Deck version, selected service, exact error label, reproduction steps, and a redacted screenshot. Never send auth files, access tokens, API keys, cookies, conversations, or full Claude settings backups.
Contact
Email support@pupupu.net for support.