feat(app-server): expose account token usage [1 of 2]#25344
Merged
Conversation
This was referenced May 30, 2026
canvrno-oai
approved these changes
Jun 1, 2026
da5112c to
618777b
Compare
etraut-openai
approved these changes
Jun 3, 2026
etraut-openai
left a comment
Collaborator
There was a problem hiding this comment.
Left one comment about token refresh that you might want to consider. Otherwise looks good.
411410b to
c375867
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
Token activity is useful account-level context, but terminal clients need a supported app-server path to fetch it without reaching into ChatGPT backend details directly. The API should also live under the broader account usage umbrella so future usage surfaces can be added without proliferating user-facing concepts.
What Changed
codex-backend-clientsupport for the ChatGPT profile token-usage payload.account/usage/readapp-server RPC.Token Count Source
account/usage/readreturns the token-usage aggregate supplied by the ChatGPT profile backend. App-server maps that backend-owned aggregate into protocol fields; it does not recompute cached-token treatment, usage multipliers, or raw input/output totals locally.Stack
How to Test
account/usage/read.summaryanddailyUsageBuckets.Targeted tests:
just test -p codex-backend-client -p codex-app-server-protocol -p codex-app-serverjust write-app-server-schema