feat(cli): polish cached token stats and simplify stats display when quota is present. by jacob314 · Pull Request #14961 · google-gemini/gemini-cli

jacob314 · 2025-12-11T20:22:08Z

Summary

This commit refactors the CLI's statistics display (/stats and /stats model) to provide a cleaner and more focused user experience.

The primary change is to simplify the main /stats view when user quota information is available. In this context, the display prioritizes the user's quota status, as that is the most actionable information. The detailed token breakdown, which can create a cluttered view, is hidden. Users who need to see the full token breakdown can use the more detailed /stats model view.

Specific changes include:

Simplified Main Stats View (/stats):
- When quota information is displayed, the model usage table is condensed to show only the model name, request count, and remaining usage.
- The detailed token columns (Input Tokens, Cache Reads, Output Tokens) and the "Savings Highlight" are now conditionally hidden in the presence of quota data to reduce information density.
Improved Detailed View (/stats model):
- The token breakdown is now more precise. "Prompt" tokens have been split into "Input" (uncached tokens) and "Cache Reads" to give a clearer view of cache efficiency.
- Labels have been updated for clarity (e.g., "Cached" is now "Cache Reads").
- Colors and layout have been polished for better readability.
Test snapshots have been updated to reflect these intentional UI improvements.

Details

/stats when using OAuth

/stats when not using OAuth

/stats model example:

How to test

Run both signed in with an API key and OAuth. Verify that you don't see spurious messages about cost savings when using Oath and that the main /stats page does not show token usage when using OAuth.

Verify that when using API Key you do not see anything quota related when using /stats and that you see Input Tokens, Output Tokens, and Cached Reads.

github-actions · 2025-12-11T20:25:05Z

Size Change: +3.23 kB (+0.01%)

Total Size: 21.6 MB

Filename	Size	Change
`./bundle/gemini.js`	21.6 MB	+3.23 kB (+0.01%)

ℹ️ View Unchanged

Filename	Size
`./bundle/sandbox-macos-permissive-closed.sb`	1.03 kB
`./bundle/sandbox-macos-permissive-open.sb`	890 B
`./bundle/sandbox-macos-permissive-proxied.sb`	1.31 kB
`./bundle/sandbox-macos-restrictive-closed.sb`	3.29 kB
`./bundle/sandbox-macos-restrictive-open.sb`	3.36 kB
`./bundle/sandbox-macos-restrictive-proxied.sb`	3.56 kB

_{compressed-size-action}

gemini-code-assist

Code Review

This pull request polishes the statistics display by improving labels, colors, and layout. The changes in ModelStatsDisplay make the token breakdown clearer. However, the refactoring of StatsDisplay and its ModelUsageTable component has led to a significant regression: key statistical information, such as token usage columns and cache savings highlights, is now hidden when user quota information is displayed. This removes valuable context for the user. My review includes feedback to address this loss of information to ensure the stats display remains comprehensive.

jacob314 · 2025-12-11T21:12:14Z

Code Review

This pull request polishes the statistics display by improving labels, colors, and layout. The changes in ModelStatsDisplay make the token breakdown clearer. However, the refactoring of StatsDisplay and its ModelUsageTable component has led to a significant regression: key statistical information, such as token usage columns and cache savings highlights, is now hidden when user quota information is displayed. This removes valuable context for the user. My review includes feedback to address this loss of information to ensure the stats display remains comprehensive.

This is a misunderstanding of what the pr is doing.

jacob314 · 2025-12-11T21:14:20Z

packages/cli/src/ui/components/StatsDisplay.tsx

-  const usageLimitWidth = quotas ? 30 : 0;
+  const usageLimitWidth = showQuotaColumn ? 28 : 0;
+
+  const cacheEfficiencyColor = getStatusColor(cacheEfficiency, {


assume this was just missed before. Gemini added it back and I left it.

jacob314 · 2025-12-11T21:15:23Z

packages/cli/src/ui/components/StatsDisplay.tsx

+          width={requestsWidth}
+          flexDirection="column"
+          alignItems="flex-end"
+          flexShrink={0}


UX is broken if this shrinks. Same elsewhere

abhipatel12

LGTM!

jacob314 · 2025-12-12T00:45:05Z

/patch preview

jacob314 · 2025-12-12T00:45:17Z

/patch stable

github-actions · 2025-12-12T00:45:22Z

✅ Patch workflow(s) dispatched successfully!

📋 Details:

Channels: preview
Commit: 54de67536da3af801bba8ab4657769d54dd30c2a
Workflows Created: 1

🔗 Track Progress:

github-actions · 2025-12-12T00:45:36Z

✅ Patch workflow(s) dispatched successfully!

📋 Details:

Channels: stable
Commit: 54de67536da3af801bba8ab4657769d54dd30c2a
Workflows Created: 1

🔗 Track Progress:

…quota is present. (#14961) # Conflicts: # packages/cli/src/ui/components/StatsDisplay.test.tsx # packages/cli/src/ui/components/StatsDisplay.tsx # packages/cli/src/ui/components/__snapshots__/StatsDisplay.test.tsx.snap

github-actions · 2025-12-12T00:48:11Z

🚀 Patch PR Created!

📋 Patch Details:

Environment: prod
Channel: stable → will publish to npm tag latest
Commit: 54de67536da3af801bba8ab4657769d54dd30c2a
Hotfix Branch: hotfix/v0.20.0/0.20.1/stable/cherry-pick-54de675/pr-14961
Hotfix PR: #14967
⚠️ Status: Cherry-pick conflicts detected - manual resolution required

📝 Next Steps:

⚠️ Resolve conflicts in the hotfix PR first: #14967
Test your changes after resolving conflicts
Once merged, the patch release will automatically trigger
You'll receive updates here when the release completes

🔗 Track Progress:

View hotfix PR #14967

…quota is present. (#14961) # Conflicts: # packages/cli/src/ui/components/StatsDisplay.test.tsx # packages/cli/src/ui/components/StatsDisplay.tsx # packages/cli/src/ui/components/__snapshots__/StatsDisplay.test.tsx.snap

github-actions · 2025-12-12T00:48:22Z

🚀 Patch PR Created!

📋 Patch Details:

Environment: prod
Channel: preview → will publish to npm tag preview
Commit: 54de67536da3af801bba8ab4657769d54dd30c2a
Hotfix Branch: hotfix/v0.21.0-preview.2/0.21.0-preview.3/preview/cherry-pick-54de675/pr-14961
Hotfix PR: #14968
⚠️ Status: Cherry-pick conflicts detected - manual resolution required

📝 Next Steps:

⚠️ Resolve conflicts in the hotfix PR first: #14968
Test your changes after resolving conflicts
Once merged, the patch release will automatically trigger
You'll receive updates here when the release completes

🔗 Track Progress:

View hotfix PR #14968

github-actions · 2025-12-12T06:40:00Z

🚀 Patch Release Started!

📋 Release Details:

Environment: prod
Channel: preview → publishing to npm tag preview
Version: v0.21.0-preview.2
Hotfix PR: Merged ✅
Release Branch: release/v0.21.0-preview.2-pr-14961

⏳ Status: The patch release is now running. You'll receive another update when it completes.

🔗 Track Progress:

View release workflow

github-actions · 2025-12-12T07:02:27Z

✅ Patch Release Complete!

📦 Release Details:

Version: 0.21.0-preview.3
NPM Tag: preview
Channel: preview
Dry Run: false

🎉 Status: Your patch has been successfully released and published to npm!

📝 What's Available:

GitHub Release: View release v0.21.0-preview.3
NPM Package: npm install @google/gemini-cli@preview

🔗 Links:

…quota is present. (google-gemini#14961)

…mplify stats display when quota is present. (google-gemini#14961)

jacob314 requested a review from a team as a code owner December 11, 2025 20:22

gemini-code-assist bot reviewed Dec 11, 2025

View reviewed changes

jacob314 force-pushed the cache_breakdown branch from 111f7a1 to c6b9699 Compare December 11, 2025 20:51

jacob314 changed the title ~~Polish stats display~~ feat(cli): simplify stats display when quota is present. Dec 11, 2025

jacob314 changed the title ~~feat(cli): simplify stats display when quota is present.~~ feat(cli): polish cached token stats and simplify stats display when quota is present. Dec 11, 2025

jacob314 force-pushed the cache_breakdown branch from c6b9699 to 69ddb85 Compare December 11, 2025 21:11

google-gemini deleted a comment from gemini-code-assist bot Dec 11, 2025

jacob314 commented Dec 11, 2025

View reviewed changes

Polish stats display

e0caae0

jacob314 force-pushed the cache_breakdown branch from 69ddb85 to e0caae0 Compare December 11, 2025 21:19

jacob314 requested a review from abhipatel12 December 11, 2025 21:20

abhipatel12 approved these changes Dec 11, 2025

View reviewed changes

jacob314 added this pull request to the merge queue Dec 11, 2025

Merged via the queue into main with commit 54de675 Dec 11, 2025
20 checks passed

jacob314 deleted the cache_breakdown branch December 11, 2025 23:27

jacob314 mentioned this pull request Dec 12, 2025

Report total input tokens with cached and non-cached breakdown #14524

Closed

theerud pushed a commit to theerud/gemini-cli that referenced this pull request Dec 12, 2025

feat(cli): polish cached token stats and simplify stats display when …

d109383

…quota is present. (google-gemini#14961)

thacio added a commit to thacio/auditaria that referenced this pull request Dec 13, 2025

Merge Commit '54de67536': feat(cli): polish cached token stats and si…

99cc69e

…mplify stats display when quota is present. (google-gemini#14961)

Conversation

jacob314 commented Dec 11, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Details

How to test

Uh oh!

github-actions bot commented Dec 11, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

gemini-code-assist bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

jacob314 commented Dec 11, 2025

Code Review

Uh oh!

jacob314 Dec 11, 2025

Choose a reason for hiding this comment

Uh oh!

jacob314 Dec 11, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

abhipatel12 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

jacob314 commented Dec 12, 2025

Uh oh!

jacob314 commented Dec 12, 2025

Uh oh!

github-actions bot commented Dec 12, 2025

Uh oh!

github-actions bot commented Dec 12, 2025

Uh oh!

github-actions bot commented Dec 12, 2025

Uh oh!

github-actions bot commented Dec 12, 2025

Uh oh!

github-actions bot commented Dec 12, 2025

Uh oh!

github-actions bot commented Dec 12, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

jacob314 commented Dec 11, 2025 •

edited

Loading

github-actions bot commented Dec 11, 2025 •

edited

Loading

jacob314 Dec 11, 2025 •

edited

Loading