mirror of
https://github.com/google-gemini/gemini-cli.git
synced 2026-03-10 22:21:22 -07:00
55 lines
1.5 KiB
Markdown
55 lines
1.5 KiB
Markdown
# Memory tool (`save_memory`)
|
|
|
|
This document describes the `save_memory` tool for the Gemini CLI.
|
|
|
|
## Description
|
|
|
|
Use `save_memory` to save and recall information across your Gemini CLI
|
|
sessions. With `save_memory`, you can direct the CLI to remember key details
|
|
across sessions, providing personalized and directed assistance.
|
|
|
|
### Arguments
|
|
|
|
`save_memory` takes one argument:
|
|
|
|
- `fact` (string, required): The specific fact or piece of information to
|
|
remember. This should be a clear, self-contained statement written in natural
|
|
language.
|
|
|
|
## How to use `save_memory` with the Gemini CLI
|
|
|
|
The tool appends the provided `fact` to a special `GEMINI.md` file located in
|
|
the user's home directory (`~/.gemini/GEMINI.md`). This file can be configured
|
|
to have a different name.
|
|
|
|
Once added, the facts are stored under a `## Gemini Added Memories` section.
|
|
This file is loaded as context in subsequent sessions, allowing the CLI to
|
|
recall the saved information.
|
|
|
|
Usage:
|
|
|
|
```
|
|
save_memory(fact="Your fact here.")
|
|
```
|
|
|
|
### `save_memory` examples
|
|
|
|
Remember a user preference:
|
|
|
|
```
|
|
save_memory(fact="My preferred programming language is Python.")
|
|
```
|
|
|
|
Store a project-specific detail:
|
|
|
|
```
|
|
save_memory(fact="The project I'm currently working on is called 'gemini-cli'.")
|
|
```
|
|
|
|
## Important notes
|
|
|
|
- **General usage:** This tool should be used for concise, important facts. It
|
|
is not intended for storing large amounts of data or conversational history.
|
|
- **Memory file:** The memory file is a plain text Markdown file, so you can
|
|
view and edit it manually if needed.
|