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

[wanglc02]

What happened?

I ran the /settings command to view the configuration options. In the General section of the UI, the option labeled Session Retention (mapped to general.sessionRetention in the docs) is not displayed.

While the sub-setting "Enable Session Cleanup" (general.sessionRetention.enabled) is visible in the UI, the parent setting "Session Retention" listed in the "Settings reference" documentation is entirely missing from the list.

What did you expect to happen?

I expected the /settings UI to include the "Session Retention" row as described in the documentation. Alternatively, if general.sessionRetention is not intended to be a configurable UI element itself, the documentation should be updated to remove it from the reference table to avoid confusion.

Client information

Client Information

Run gemini to enter the interactive CLI, then run the /about command.

> /about
CLI Version  0.19.4
Git Commit   93511487
Model        auto
Sandbox      no sandbox
OS           darwin
Auth Method  gemini-api-key

Login information

API key

Anything else we need to know?

• Current UI shows: Enable Session Cleanup only.
• Documentation lists: Both Session Retention and Enable Session Cleanup.

[afarber]

Thanks for catching this! After digging into the code, turns out sessionRetention is just a container/namespace that groups related settings together - it's not meant to be configured directly. The schema has showInDialog: false on it intentionally.

The actual setting you can toggle is sessionRetention.enabled which does show up in the UI. The docs just had an extra row that shouldn't have been there. PR incoming to fix it.