PR #25352: fix(cli): Massive logs cause scrolling lag and inefficient positioning

• Repository: google-gemini/gemini-cli
• Author: mini2s
• State: open | merged: False
• Link: https://github.com/google-gemini/gemini-cli/pull/25352

Description (problem / solution / changelog)

Summary

Add search and level-based filtering to the debug console so users can narrow console output faster when troubleshooting. This improves both the CLI debug console experience and the devtools client by making high-volume logs easier to inspect. @Samee24

录屏 2026-04-13 16-58-32.webm

录屏 2026-04-13 16-05-36.webm

Details

• Adds console log filtering by level (All, Log, Info, Warn, Error, Debug) and free-text search in the devtools client.
• Introduces reusable filtering helpers and test coverage for count calculation, level filtering, text filtering, combined filters, and empty-result behavior.
• Extends console message data with stable id support to improve list rendering and filtering behavior.
• Adds theme support for per-log-level colors across CLI themes, semantic tokens, and custom theme configuration.
• Prevents IDE context detail from being triggered while the debug console is open, avoiding shortcut conflicts during debugging.
• Updates CLI UI tests and snapshots to cover the new debug console behavior and theme changes.

Related Issues

https://github.com/google-gemini/gemini-cli/issues/25439

How to Validate

1. Run the relevant test suites:
   • npm test -- packages/devtools/client/src/App.test.ts
   • npm test -- packages/cli/src/ui/components/DetailedMessagesDisplay.test.tsx
   • npm test -- packages/cli/src/ui/hooks/useConsoleMessages.test.tsx
2. Start the devtools client and open the console view.
3. Verify level filter buttons show counts for each log type and correctly filter displayed logs.
4. Enter search text and confirm matching is case-insensitive and trims surrounding whitespace.
5. Combine a level filter with search text and confirm only matching logs remain.
6. Clear filters and confirm the full log list returns.
7. In CLI debug console flow, verify F12 opens error/debug details and F4 does not trigger IDE context detail while the debug console is open.
8. Optionally switch themes or use a custom theme and confirm log levels render with distinct colors.

Pre-Merge Checklist

• Updated relevant documentation and README (if needed)
• Added/updated tests (if needed)
• Noted breaking changes (if any)
• Validated on required platforms/methods:
  • MacOS
    • npm run
    • npx
    • Docker
    • Podman
    • Seatbelt
  • Windows
    • npm run
    • npx
    • Docker
  • Linux
    • npm run
    • npx
    • Docker

Changed files

• packages/cli/src/ui/AppContainer.test.tsx (modified, +16/-0)
• packages/cli/src/ui/AppContainer.tsx (modified, +1/-0)
• packages/cli/src/ui/components/ColorsDisplay.test.tsx (modified, +14/-0)
• packages/cli/src/ui/components/Composer.test.tsx (modified, +26/-1)
• packages/cli/src/ui/components/Composer.tsx (modified, +7/-0)
• packages/cli/src/ui/components/DetailedMessagesDisplay.test.tsx (modified, +399/-21)
• packages/cli/src/ui/components/DetailedMessagesDisplay.tsx (modified, +279/-49)
• packages/cli/src/ui/components/Header.test.tsx (modified, +7/-0)
• packages/cli/src/ui/components/__snapshots__/DetailedMessagesDisplay.test.tsx.snap (modified, +33/-8)
• packages/cli/src/ui/components/__snapshots__/ThemeDialog.test.tsx.snap (modified, +10/-0)
• packages/cli/src/ui/components/shared/TextInput.tsx (modified, +6/-1)
• packages/cli/src/ui/hooks/useConsoleMessages.test.tsx (modified, +27/-10)
• packages/cli/src/ui/hooks/useConsoleMessages.ts (modified, +7/-2)
• packages/cli/src/ui/semantic-colors.ts (modified, +3/-0)
• packages/cli/src/ui/themes/builtin/dark/solarized-dark.ts (modified, +7/-0)
• packages/cli/src/ui/themes/builtin/light/solarized-light.ts (modified, +7/-0)
• packages/cli/src/ui/themes/builtin/no-color.ts (modified, +7/-0)
• packages/cli/src/ui/themes/semantic-tokens.ts (modified, +21/-0)
• packages/cli/src/ui/themes/theme-manager.ts (modified, +7/-0)
• packages/cli/src/ui/themes/theme.ts (modified, +14/-0)
• packages/cli/src/ui/types.ts (modified, +1/-0)
• packages/core/src/config/config.ts (modified, +7/-0)
• packages/devtools/client/src/App.test.ts (added, +65/-0)
• packages/devtools/client/src/App.tsx (modified, +206/-15)