Skip to content

[SSR Agent] Issue Fix (19239): Update /clear command docs to include context reset - #28847

Merged
joneba-google merged 1 commit into
google-gemini:mainfrom
JonE01:ssr-agent-19239-v2
Aug 17, 2026
Merged

joneba-google merged 1 commit into
google-gemini:mainfrom
JonE01:ssr-agent-19239-v2

Conversation

@joneba-google

Copy link
Copy Markdown
Contributor

fixes #19239
#19239

Context & Problem

The documentation for the /clear command in docs/reference/commands.md incorrectly stated that it only clears the visual terminal screen and scrollback, failing to mention that it also clears the active conversation context and starts a new session.

Detailed Changes

  • Updated the /clear command description in commands.md to clarify that running /clear resets the agent's conversation context and starts a new session in addition to clearing the visible terminal screen.
  • Clarified the keyboard shortcut behavior, explicitly explaining that Ctrl+L only performs a visual clear of the screen while preserving the active conversation context, and that /clear must be used to start a new session.

Verification

  • Reviewed the documentation changes to ensure they are clear, accurate, and completely satisfy the expected behavior in the specification.

…context reset

$fixes google-gemini#19239
google-gemini#19239

### Context & Problem

The documentation for the `/clear` command in `docs/reference/commands.md` incorrectly stated that it only clears the visual terminal screen and scrollback, failing to mention that it also clears the active conversation context and starts a new session.

### Detailed Changes

- Updated the `/clear` command description in [commands.md](file:///usr/local/google/home/joneba/ssr-prototype/gcli-intern-project/tools/caretaker-agent/evals/pr-generation/run_outputs/onboarded_triaged_3.5_flash/agent_environments/issue_19239/tmp/eval/gemini-cli-clone/docs/reference/commands.md) to clarify that running `/clear` resets the agent's conversation context and starts a new session in addition to clearing the visible terminal screen.
- Clarified the keyboard shortcut behavior, explicitly explaining that **Ctrl+L** only performs a visual clear of the screen while preserving the active conversation context, and that `/clear` must be used to start a new session.

### Verification

- Reviewed the documentation changes to ensure they are clear, accurate, and completely satisfy the expected behavior in the specification.
@joneba-google
joneba-google requested review from a team as code owners August 16, 2026 19:46
@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 an issue where the documentation for the /clear command was misleading regarding its functionality. The changes clarify that the command resets the conversation context and initiates a new session, while also distinguishing this behavior from the visual-only clear provided by the Ctrl+L shortcut.

Highlights

  • Documentation Update: Updated the /clear command description to accurately reflect that it resets the conversation context and starts a new session.
  • Shortcut Clarification: Clarified the distinction between the Ctrl+L keyboard shortcut, which only performs a visual clear, and the /clear command.
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 the 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 counterproductive. 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. ↩

@github-actions github-actions Bot added the size/s A small PR label Aug 16, 2026
@github-actions

Copy link
Copy Markdown

📊 PR Size: size/S

  • Lines changed: 12
  • Additions: +7
  • Deletions: -5
  • Files changed: 1

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

Copy link
Copy Markdown
Contributor

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/reference/commands.md to clarify the behavior of the /clear command and the Ctrl+L keyboard shortcut. Specifically, it explains that /clear resets the active agent conversation context and starts a new session, whereas Ctrl+L only visually clears the terminal display while preserving the conversation context. There are no review comments, and 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/agent Issues related to Core Agent, Tools, Memory, Sub-Agents, Hooks, Agent Quality help wanted We will accept PRs from all issues marked as "help wanted". Thanks for your support! labels Aug 16, 2026

@adamfweidman adamfweidman left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

LGTM

@joneba-google
joneba-google added this pull request to the merge queue Aug 17, 2026
Merged via the queue into google-gemini:main with commit 962b8a2 Aug 17, 2026
33 of 34 checks passed
@joneba-google
joneba-google deleted the ssr-agent-19239-v2 branch August 17, 2026 22:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/agent Issues related to Core Agent, Tools, Memory, Sub-Agents, Hooks, Agent Quality 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. size/s A small PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

/clear docs dont mention that it clears context

2 participants