gemini-cli-engram
Persistent long-term memory for Gemini CLI using Engram MCP.
Open source Open in the app JSON README (API)
About
Persistent long-term memory for Gemini CLI using Engram MCP.
Details
- Kind
- Plugins
- Topic
- AI, RAG & memory
- Publisher
- anthuanvasquez
- Origin
- gemini
- Category
- ferramentas
- Version
- 1.0.0
- Stars
- 2
- Last push
- 2026-03-04T05:28:27Z
- Repository state
- arquivado
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-30 14:13:39
- Updated
- 2026-08-30 14:13:39
- Origin id
anthuanvasquez/gemini-cli-engram
README
# Engram Extension for Gemini CLI This extension integrates [Engram](https://github.com/Gentleman-Programming/engram) with Gemini CLI to provide long-term persistent memory between sessions. ## Features - **Persistent Memory:** Save discoveries, architectural decisions, and bug fixes. - **Session Context:** Automatically retrieves context from previous sessions at startup. - **Memory Protocol:** Built-in instructions (`GEMINI.md`) that guide the agent on what and when to save. - **Automated Hooks:** Startup and shutdown notifications to ensure memory hygiene. - **Custom Commands:** Directly interact with your memory from the CLI. ## Requirements - [Engram](https://github.com/Gentleman-Programming/engram) must be installed on your system and available in your `PATH`. ## Installation To link this extension locally from the project root: ```bash gemini extensions link . ``` or ```bash gemini extensions install https://github.com/anthuanvasquez/gemini-cli-engram ``` To uninstall this extension: ```bash gemini extensions uninstall gemini-cli-engram ``` ## Custom Commands Once linked, you can use these commands directly in your terminal: - **`gemini mem:stats`**: Show general statistics of your Engram memory. - **`gemini mem:search "query"`**: Perform a full-text search across all your saved memories. - **`gemini mem:context [project]`**: Show the most recent context and summaries for a specific project. ## How it Works When a session starts, the extension: 1. Activates the Engram MCP server. 2. Loads the memory protocol from `GEMINI.md`. 3. Executes a `SessionStart` hook that displays current Engram statistics. During the session, the agent will follow the rules defined in the protocol to save relevant information using `mem_save` and retrieve context using `mem_context`. At the end of the session, the agent will be reminded to save a summary (`mem_session_summary`).