groktok

A terminal tool that reports weekly usage, monthly allotment, local token counts and a lifetime cost comparison in dollars per million tokens.

A subscription, credit purchases and token usage are three numbers that never appear together. Working out whether you are getting value means reconciling a billing page against usage logs by hand, so most people never do it and simply hope.

1. 1

   Reads the same billing data that powers the account usage page, so the numbers agree with the source rather than estimating.

2. 2

   Adds local token counts from this machine's session logs for the same billing window, which is the half the billing page cannot see.

3. 3

   Reduces it to one comparable figure: dollars per million tokens across the lifetime of the account.

• Python 3.9+ with zero third-party dependencies
• Weekly pool, monthly allotment and remaining credit in one view
• Installs as a single tool via uv

• Python
• CLI