Skip to content

docs(cli): point plan-mode session retention to actual /settings labels#25978

Merged
spencer426 merged 3 commits intogoogle-gemini:mainfrom
ifitisit:fix/14623-plan-mode-session-retention-label
Apr 28, 2026
Merged

docs(cli): point plan-mode session retention to actual /settings labels#25978
spencer426 merged 3 commits intogoogle-gemini:mainfrom
ifitisit:fix/14623-plan-mode-session-retention-label

Conversation

@ifitisit
Copy link
Copy Markdown
Contributor

@ifitisit ifitisit commented Apr 25, 2026

Summary

docs/cli/plan-mode.md told users to "customize this behavior via the /settings command (search for Session Retention)", but that label no longer exists in the /settings dialog. The schema marks general.sessionRetention as showInDialog: false (a parent grouping), so the dialog only renders the leaves: Enable Session Cleanup (general.sessionRetention.enabled) and Keep chat history (general.sessionRetention.maxAge). A user following the doc would search the dialog and find nothing.

Details

Updated the parenthetical to reference the labels that actually appear in the dialog (matching the autogenerated table in docs/cli/settings.md lines 40-41). Wording, the surrounding link to session-management.md#session-retention, and the rest of the Cleanup section are unchanged.

This is a follow-up cleanup for the same root cause as #14623; the primary symptom (a missing parent row in the settings reference table) was already addressed when docs/cli/settings.md became autogenerated, but this stale instruction in plan-mode.md was missed.

Related Issues

Fixes #14623

How to Validate

  1. Run the CLI from source: npm start
  2. Type /settings and look at the General category.
  3. Confirm the rows Enable Session Cleanup and Keep chat history are present.
  4. Confirm there is no row labelled Session Retention (it's a showInDialog: false parent — see packages/cli/src/config/settingsSchema.ts:373-421).
  5. Read docs/cli/plan-mode.md § Cleanup and confirm the configuration bullet now points at labels you can actually find in step 3.

Pre-Merge Checklist

  • Updated relevant documentation and README (if needed)
  • Added/updated tests (if needed) — docs-only change, no tests
  • Noted breaking changes (if any) — none
  • Validated on required platforms/methods:
    • MacOS
      • npm run

The Cleanup section of plan-mode.md instructed users to "search for
Session Retention" in /settings, but that label no longer appears in the
dialog. The schema marks general.sessionRetention as showInDialog: false,
so only its leaves are rendered ("Enable Session Cleanup" and "Keep chat
history"). Update the parenthetical to point at the labels users will
actually find.

Refs google-gemini#14623
@ifitisit ifitisit requested review from a team as code owners April 25, 2026 18:03
@gemini-code-assist
Copy link
Copy Markdown
Contributor

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request addresses a documentation discrepancy where the CLI guide referenced a non-existent setting label. By updating the instructions to match the actual UI labels, the change ensures that users can correctly locate and configure session retention settings within the application.

Highlights

  • Documentation Update: Updated the CLI documentation in plan-mode.md to accurately reflect the settings labels present in the /settings dialog.
  • Improved User Experience: Replaced the stale 'Session Retention' reference with the actual labels 'Enable Session Cleanup' and 'Keep chat history' to help users locate configuration options more easily.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the documentation in docs/cli/plan-mode.md to reflect changes in the /settings command search terms for session retention, specifically replacing 'Session Retention' with 'Enable Session Cleanup' or 'Keep chat history'. I have no feedback to provide.

Note: Security Review has been skipped due to the limited scope of the PR.

@gemini-cli gemini-cli Bot added priority/p3 Backlog - a good idea but not currently a priority. area/core Issues related to User Interface, OS Support, Core Functionality help wanted We will accept PRs from all issues marked as "help wanted". Thanks for your support! labels Apr 25, 2026
Copy link
Copy Markdown
Contributor

@spencer426 spencer426 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@spencer426 spencer426 enabled auto-merge April 28, 2026 21:02
@spencer426 spencer426 added this pull request to the merge queue Apr 28, 2026
Merged via the queue into google-gemini:main with commit 9e7c924 Apr 28, 2026
26 of 27 checks passed
TirthNaik-99 pushed a commit to TirthNaik-99/gemini-cli that referenced this pull request May 4, 2026
kimjune01 pushed a commit to kimjune01/gemini-cli-claude that referenced this pull request May 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/core Issues related to User Interface, OS Support, Core Functionality help wanted We will accept PRs from all issues marked as "help wanted". Thanks for your support! priority/p3 Backlog - a good idea but not currently a priority.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Doc/UI Mismatch] "Session Retention" setting is missing from /settings UI but present in documentation

2 participants