PR #26048: feat(prototype): Behavioral Tip Personalization (one of the ideas from my gsoc proposal)

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

Description (problem / solution / changelog)

Summary

This is a prototype implementation of Behavioral Tip Personalization, derived from my GSoC proposal ("Adaptive Discovery: Personalized UX and Automated Knowledge Sync for Gemini CLI").

NOTE: This is a PROTOTYPE and is NOT intended for merging. It is created as a proof-of-concept for the "Personal Recommender" feature.

Details

This PR introduces a feedback loop between user behavior and onboarding:

• Persistent State: Added featureUsageCounts to track interaction with specific CLI features.
• Tip Metadata: Refactored INFORMATIVE_TIPS from strings to objects with relatedFeature tags.
• Weighted Selection: Implemented a selection algorithm in usePhraseCycler that prioritizes tips for features the user hasn't used yet.
• Instrumentation: Added usage tracking to slash commands, @mentions, and shell commands.

Related Issues

Related to #26047

How to Validate

1. Switch to this branch: gsoc-tips-personalization-prototype.
2. Run the CLI and trigger various features (e.g., /settings, !ls, @GEMINI.md).
3. Observe the loading screen tips. Tips for the features you just used should appear less frequently, while tips for unused features (like mcp or todos) should be prioritized.

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/constants/tips.ts (modified, +460/-152)
• packages/cli/src/ui/hooks/atCommandProcessor.ts (modified, +4/-0)
• packages/cli/src/ui/hooks/slashCommandProcessor.ts (modified, +5/-0)
• packages/cli/src/ui/hooks/useExecutionLifecycle.ts (modified, +4/-0)
• packages/cli/src/ui/hooks/usePhraseCycler.ts (modified, +31/-4)
• packages/cli/src/utils/persistentState.ts (modified, +9/-0)