Skip to content

Commit cb00807

Browse files
committed
chore: clean up launched memory features
1 parent ebe1555 commit cb00807

80 files changed

Lines changed: 596 additions & 4166 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

docs/cli/auto-memory.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -29,11 +29,10 @@ You'll use Auto Memory when you want to:
2929
avoid them.
3030
- **Bootstrap a skills library** without writing every `SKILL.md` by hand.
3131

32-
Auto Memory complements—but does not replace—the
33-
[`save_memory` tool](../tools/memory.md), which captures single facts into
34-
`GEMINI.md` when the agent explicitly calls it. Auto Memory infers candidates
35-
from past sessions, writes reviewable patches or skill drafts, and never applies
36-
them without your approval.
32+
Auto Memory complements direct memory-file editing. The agent can still persist
33+
explicit user instructions by editing the appropriate markdown memory file; Auto
34+
Memory infers candidates from past sessions, writes reviewable patches or skill
35+
drafts, and never applies them without your approval.
3736

3837
## Prerequisites
3938

docs/cli/gemini-md.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -65,8 +65,6 @@ You can interact with the loaded context files by using the `/memory` command.
6565
being provided to the model.
6666
- **`/memory reload`**: Forces a re-scan and reload of all `GEMINI.md` files
6767
from all configured locations.
68-
- **`/memory add <text>`**: Appends your text to your global
69-
`~/.gemini/GEMINI.md` file. This lets you add persistent memories on the fly.
7068

7169
## Modularize context with imports
7270

docs/cli/plan-mode.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -138,7 +138,6 @@ These are the only allowed tools:
138138
[`replace`](../tools/file-system.md#6-replace-edit) only allowed for `.md`
139139
files in the `~/.gemini/tmp/<project>/<session-id>/plans/` directory or your
140140
[custom plans directory](#custom-plan-directory-and-policies).
141-
- **Memory:** [`save_memory`](../tools/memory.md)
142141
- **Skills:** [`activate_skill`](../cli/skills.md) (allows loading specialized
143142
instructions and resources in a read-only manner)
144143

docs/cli/settings.md

Lines changed: 18 additions & 19 deletions
Large diffs are not rendered by default.

docs/cli/tutorials/memory-management.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -71,8 +71,8 @@ Just tell the agent to remember something.
7171

7272
**Prompt:** `Remember that I prefer using 'const' over 'let' wherever possible.`
7373

74-
The agent will use the `save_memory` tool to store this fact in your global
75-
memory file.
74+
The agent will edit the appropriate memory markdown file directly so the fact is
75+
loaded in future sessions.
7676

7777
**Prompt:** `Save the fact that the staging server IP is 10.0.0.5.`
7878

docs/reference/commands.md

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -265,9 +265,6 @@ Slash commands provide meta-level control over the CLI itself.
265265
- **Description:** Manage the AI's instructional context (hierarchical memory
266266
loaded from `GEMINI.md` files).
267267
- **Sub-commands:**
268-
- **`add`**:
269-
- **Description:** Adds the following text to the AI's memory. Usage:
270-
`/memory add <text to remember>`
271268
- **`list`**:
272269
- **Description:** Lists the paths of the GEMINI.md files in use for
273270
hierarchical memory.

docs/reference/configuration.md

Lines changed: 0 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1857,13 +1857,6 @@ their corresponding top-level category object in your `settings.json` file.
18571857
- **Default:** `false`
18581858
- **Requires restart:** Yes
18591859

1860-
- **`experimental.jitContext`** (boolean):
1861-
- **Description:** Enable Just-In-Time (JIT) context loading. Defaults to
1862-
true; set to false to opt out and load all GEMINI.md files into the system
1863-
instruction up-front.
1864-
- **Default:** `true`
1865-
- **Requires restart:** Yes
1866-
18671860
- **`experimental.useOSC52Paste`** (boolean):
18681861
- **Description:** Use OSC 52 for pasting. This may be more robust than the
18691862
default system when using remote terminal sessions (if your terminal is
@@ -1926,19 +1919,6 @@ their corresponding top-level category object in your `settings.json` file.
19261919
- **Default:** `"gemma3-1b-gpu-custom"`
19271920
- **Requires restart:** Yes
19281921

1929-
- **`experimental.memoryV2`** (boolean):
1930-
- **Description:** Disable the built-in save_memory tool and let the main
1931-
agent persist project context by editing markdown files directly with
1932-
edit/write_file. Route facts across four tiers: team-shared conventions go
1933-
to project GEMINI.md files, project-specific personal notes go to the
1934-
per-project private memory folder (MEMORY.md as index + sibling .md files
1935-
for detail), and cross-project personal preferences go to the global
1936-
~/.gemini/GEMINI.md (the only file under ~/.gemini/ that the agent can edit
1937-
— settings, credentials, etc. remain off-limits). Set to false to fall back
1938-
to the legacy save_memory tool.
1939-
- **Default:** `true`
1940-
- **Requires restart:** Yes
1941-
19421922
- **`experimental.stressTestProfile`** (boolean):
19431923
- **Description:** Significantly lowers token limits to force early garbage
19441924
collection and distillation for testing purposes.

docs/reference/tools.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -120,7 +120,6 @@ each tool.
120120
| :----------------------------------------------- | :------ | :----------------------------------------------------------------------------------- |
121121
| [`activate_skill`](../tools/activate-skill.md) | `Other` | Loads specialized procedural expertise from the `.gemini/skills` directory. |
122122
| [`get_internal_docs`](../tools/internal-docs.md) | `Think` | Accesses Gemini CLI's own documentation for accurate answers about its capabilities. |
123-
| [`save_memory`](../tools/memory.md) | `Think` | Persists specific facts and project details to your `GEMINI.md` file. |
124123

125124
### Planning
126125

@@ -173,7 +172,6 @@ representation of each tool's arguments.
173172
| `replace` | `file_path`, `old_string`, `new_string`, `instruction`, `allow_multiple` |
174173
| `ask_user` | `questions` (array of `question`, `header`, `type`, `options`) |
175174
| `write_todos` | `todos` (array of `description`, `status`) |
176-
| `save_memory` | `fact` |
177175
| `activate_skill` | `name` |
178176
| `get_internal_docs` | `path` |
179177
| `enter_plan_mode` | `reason` |

docs/tools/memory.md

Lines changed: 10 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,22 @@
1-
# Memory tool (`save_memory`)
1+
# Memory files
22

3-
The `save_memory` tool allows the Gemini agent to persist specific facts, user
4-
preferences, and project details across sessions.
3+
Gemini CLI persists durable facts, user preferences, and project details by
4+
editing markdown memory files directly.
55

66
## Technical reference
77

8-
This tool appends information to the `## Gemini Added Memories` section of your
9-
global `GEMINI.md` file (typically located at `~/.gemini/GEMINI.md`).
10-
11-
### Arguments
12-
13-
- `fact` (string, required): A clear, self-contained statement in natural
14-
language.
8+
The agent routes memories to the appropriate markdown file: shared project
9+
instructions go in repository `GEMINI.md` files, private project notes go in the
10+
per-project private memory folder, and cross-project personal preferences go in
11+
the global `~/.gemini/GEMINI.md` file.
1512

1613
## Technical behavior
1714

18-
- **Storage:** Appends to the global context file in the user's home directory.
15+
- **Storage:** Edits markdown files with `write_file` or `replace`.
1916
- **Loading:** The stored facts are automatically included in the hierarchical
2017
context system for all future sessions.
21-
- **Format:** Saves data as a bulleted list item within a dedicated Markdown
22-
section.
18+
- **Format:** Keeps durable instructions concise and avoids duplicating the same
19+
fact across multiple memory tiers.
2320

2421
## Use cases
2522

0 commit comments

Comments
 (0)