Skip to content

docs: clarify Auto Memory proposes memory updates and skills#26527

Merged
SandyTao520 merged 1 commit intomainfrom
st/docs/auto-memory
May 5, 2026
Merged

docs: clarify Auto Memory proposes memory updates and skills#26527
SandyTao520 merged 1 commit intomainfrom
st/docs/auto-memory

Conversation

@SandyTao520
Copy link
Copy Markdown
Contributor

Summary

Updates the Auto Memory documentation to reflect that the feature now proposes
both durable memory updates (as .patch files) and reusable Agent
Skills
, rather than skills alone. Clarifies the review/approval flow, the
safety boundaries on what Auto Memory can and cannot touch, and the data/privacy
implications of model-based extraction.

Details

  • Reframes the Overview, "How it works", and "How to review" sections to
    describe both memory patches and skill drafts.
  • Documents the inbox grouping (new skills, skill updates, memory updates) and
    the apply/dismiss actions for private vs. global memory patches.
  • Adds the new prerequisite wording (per-session 10-message threshold; sub-agent
    sessions ignored) and the throttling/state-file behavior.
  • Clarifies that project GEMINI.md files are out of scope for auto-extraction
    — only private project memory, global personal memory, and skills can be
    proposed.
  • Updates the data/privacy section to be explicit that transcript excerpts may
    be sent to the configured model during extraction.
  • Minor cross-link fix in docs/cli/tutorials/memory-management.md.

No code changes; documentation only.

Related Issues

Related to #18007

How to Validate

  1. Check out this branch.
  2. Open docs/cli/auto-memory.md and verify the rendered Markdown reads
    cleanly (headings, lists, callouts, links).
  3. Confirm the linked anchors resolve:
    • ./skills.md and ./skills.md#skill-discovery-tiers
    • ../tools/memory.md
    • ./settings.md#experimental
    • ./tutorials/memory-management.md
  4. Open docs/cli/tutorials/memory-management.md and confirm the updated
    Auto Memory cross-link wording.
  5. Optionally run npm run lint to confirm no Markdown/Prettier regressions.

Pre-Merge Checklist

  • Updated relevant documentation and README (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

@SandyTao520 SandyTao520 requested review from a team as code owners May 5, 2026 18:18
@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 updates the Auto Memory documentation to accurately reflect its expanded capabilities. The changes clarify that the feature now supports both memory patches and skill drafts, provides updated guidance on the review process, and includes important details regarding data privacy and system prerequisites. These updates ensure users have a clear understanding of how the system proposes, validates, and applies changes to their environment.

Highlights

  • Expanded Auto Memory Scope: Updated documentation to reflect that Auto Memory now proposes both durable memory updates (via .patch files) and reusable Agent Skills.
  • Refined Review and Safety Workflows: Clarified the inbox grouping, approval/dismissal processes, and explicit safety boundaries, noting that project GEMINI.md files are excluded from auto-extraction.
  • Updated Prerequisites and Privacy: Added details regarding the 10-message session threshold, sub-agent session filtering, and explicit disclosure that transcript excerpts may be processed by the model during extraction.
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.

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 for the experimental Auto Memory feature to reflect its expanded capabilities. Beyond extracting reusable Agent Skills, the feature now supports proposing durable memory updates via unified diff .patch files. The documentation has been revised to include details on the new review process in the /memory inbox, safety boundaries that prevent direct file edits, and updated prerequisites for session analysis. I have no feedback to provide as there were no review comments.

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

@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 5, 2026

Size Change: -4 B (0%)

Total Size: 34 MB

Filename Size Change
./bundle/chunk-2FYZLGZO.js 0 B -14.7 MB (removed) 🏆
./bundle/chunk-2MLCQYIU.js 0 B -3.43 kB (removed) 🏆
./bundle/chunk-6DHHNIXI.js 0 B -2.78 MB (removed) 🏆
./bundle/chunk-7DI4UAL6.js 0 B -19.5 kB (removed) 🏆
./bundle/chunk-GEBXPFA6.js 0 B -49.2 kB (removed) 🏆
./bundle/chunk-L2OLO656.js 0 B -658 kB (removed) 🏆
./bundle/chunk-NGHAFHYE.js 0 B -12.5 kB (removed) 🏆
./bundle/chunk-TMUJBMM7.js 0 B -3.8 kB (removed) 🏆
./bundle/core-7VDBELN5.js 0 B -48.7 kB (removed) 🏆
./bundle/devtoolsService-EVVM3TTM.js 0 B -28 kB (removed) 🏆
./bundle/gemini-73AHUN36.js 0 B -583 kB (removed) 🏆
./bundle/interactiveCli-BJ5ZUZGL.js 0 B -1.29 MB (removed) 🏆
./bundle/liteRtServerManager-WZ5RGPME.js 0 B -2.11 kB (removed) 🏆
./bundle/oauth2-provider-HSPEWCTQ.js 0 B -9.16 kB (removed) 🏆
./bundle/chunk-2UBOSIUW.js 14.7 MB +14.7 MB (new file) 🆕
./bundle/chunk-3YKQDAAY.js 658 kB +658 kB (new file) 🆕
./bundle/chunk-5GUAAOVF.js 49.2 kB +49.2 kB (new file) 🆕
./bundle/chunk-BDIUXD63.js 3.43 kB +3.43 kB (new file) 🆕
./bundle/chunk-JZ3AYHQJ.js 3.8 kB +3.8 kB (new file) 🆕
./bundle/chunk-NJKFEW7H.js 2.78 MB +2.78 MB (new file) 🆕
./bundle/chunk-OSI7XOIB.js 12.5 kB +12.5 kB (new file) 🆕
./bundle/chunk-XOZQWLDW.js 19.5 kB +19.5 kB (new file) 🆕
./bundle/core-2NHYDGVU.js 48.7 kB +48.7 kB (new file) 🆕
./bundle/devtoolsService-WLEZGPGH.js 28 kB +28 kB (new file) 🆕
./bundle/gemini-ZJQ7THHA.js 583 kB +583 kB (new file) 🆕
./bundle/interactiveCli-JPBYOIQW.js 1.29 MB +1.29 MB (new file) 🆕
./bundle/liteRtServerManager-4JK5OMSE.js 2.11 kB +2.11 kB (new file) 🆕
./bundle/oauth2-provider-WYCVKW33.js 9.16 kB +9.16 kB (new file) 🆕
ℹ️ View Unchanged
Filename Size Change
./bundle/bundled/third_party/index.js 8 MB 0 B
./bundle/chunk-34MYV7JD.js 2.45 kB 0 B
./bundle/chunk-5AUYMPVF.js 858 B 0 B
./bundle/chunk-5PS3AYFU.js 1.18 kB 0 B
./bundle/chunk-664ZODQF.js 124 kB 0 B
./bundle/chunk-DAHVX5MI.js 206 kB 0 B
./bundle/chunk-ECNYAST2.js 1.97 MB 0 B
./bundle/chunk-IUUIT4SU.js 56.5 kB 0 B
./bundle/chunk-RJTRUG2J.js 39.8 kB 0 B
./bundle/cleanup-D7NOHH5C.js 0 B -932 B (removed) 🏆
./bundle/devtools-36NN55EP.js 696 kB 0 B
./bundle/dist-T73EYRDX.js 356 B 0 B
./bundle/events-XB7DADIJ.js 418 B 0 B
./bundle/examples/hooks/scripts/on-start.js 188 B 0 B
./bundle/examples/mcp-server/example.js 1.43 kB 0 B
./bundle/gemini.js 5.1 kB 0 B
./bundle/getMachineId-bsd-TXG52NKR.js 1.55 kB 0 B
./bundle/getMachineId-darwin-7OE4DDZ6.js 1.55 kB 0 B
./bundle/getMachineId-linux-SHIFKOOX.js 1.34 kB 0 B
./bundle/getMachineId-unsupported-5U5DOEYY.js 1.06 kB 0 B
./bundle/getMachineId-win-6KLLGOI4.js 1.72 kB 0 B
./bundle/memoryDiscovery-FB7MMKTA.js 980 B 0 B
./bundle/multipart-parser-KPBZEGQU.js 11.7 kB 0 B
./bundle/node_modules/@google/gemini-cli-devtools/dist/client/main.js 222 kB 0 B
./bundle/node_modules/@google/gemini-cli-devtools/dist/src/_client-assets.js 229 kB 0 B
./bundle/node_modules/@google/gemini-cli-devtools/dist/src/index.js 13.4 kB 0 B
./bundle/node_modules/@google/gemini-cli-devtools/dist/src/types.js 132 B 0 B
./bundle/sandbox-macos-permissive-open.sb 890 B 0 B
./bundle/sandbox-macos-permissive-proxied.sb 1.31 kB 0 B
./bundle/sandbox-macos-restrictive-open.sb 3.36 kB 0 B
./bundle/sandbox-macos-restrictive-proxied.sb 3.56 kB 0 B
./bundle/sandbox-macos-strict-open.sb 4.82 kB 0 B
./bundle/sandbox-macos-strict-proxied.sb 5.02 kB 0 B
./bundle/src-QVCVGIUX.js 47 kB 0 B
./bundle/start-DDL5MGZA.js 0 B -652 B (removed) 🏆
./bundle/tree-sitter-7U6MW5PS.js 274 kB 0 B
./bundle/tree-sitter-bash-34ZGLXVX.js 1.84 MB 0 B
./bundle/cleanup-G7IV7P64.js 932 B +932 B (new file) 🆕
./bundle/start-QIDUJ7KW.js 652 B +652 B (new file) 🆕

compressed-size-action

Copy link
Copy Markdown
Contributor

@jkcinouye jkcinouye left a comment

Choose a reason for hiding this comment

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

LGTM

@gemini-cli gemini-cli Bot added the area/unknown Triage automation assigns this label to issues that it is unable to classify label May 5, 2026
@SandyTao520 SandyTao520 added this pull request to the merge queue May 5, 2026
Merged via the queue into main with commit f17cfb2 May 5, 2026
28 checks passed
@SandyTao520 SandyTao520 deleted the st/docs/auto-memory branch May 5, 2026 19:56
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/unknown Triage automation assigns this label to issues that it is unable to classify

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants