Gemini CLI
Install the official Nowledge Mem Gemini extension and wire Gemini CLI to local or remote Mem in about a minute.
Now live in the Extensions Gallery
Install Nowledge Mem from the official Gemini Extensions Gallery, restart Gemini CLI, and let nmem handle memory operations underneath.
Prefer manual install?
You can still install from GitHub or a local checkout at the end of this page. The official gallery path below is now the default recommendation.
For most users, the mental model is simple: install the extension from the gallery, make sure nmem works once, then start a new Gemini session.
Before You Start
- Nowledge Mem running locally (installation) or a reachable remote Mem server
- Gemini CLI installed
nmemin yourPATH
If Nowledge Mem is already running on the same machine through the desktop app, the easiest path is Settings -> Preferences -> Developer Tools -> Install CLI. That installs the bundled nmem CLI and points it at the default local Mem server.
You can also install nmem standalone:
# Option 1: pip
pip install nmem-cli
# Option 2: uvx
curl -LsSf https://astral.sh/uv/install.sh | sh
uvx --from nmem-cli nmem --versionOne-Minute Setup
Find Nowledge Mem in the gallery
Open the Gemini CLI Extensions Gallery and search for Nowledge Mem.
Install and restart
Install the extension, then restart Gemini CLI.
Run nmem status once
For the default same-machine setup, this should point to http://127.0.0.1:14242 (default).
Open a new Gemini CLI session
The extension will load GEMINI.md, discover its commands, and make the bundled skills available automatically.
Update
gemini extensions update nowledge-mem-gemini-cliIf you prefer the gallery, opening the Gemini CLI Extensions Gallery and updating Nowledge Mem reaches the same result. The important part is to start a fresh Gemini session after the update.
Customize Safely
Use Gemini's own context files for behavior changes:
- project
GEMINI.md - optional
~/.gemini/GEMINI.mdfor personal defaults
If the rule grows, split it into files and import them with @file.md. Do not edit the installed extension files directly. Full map: Customize Integration Behavior.
Your First Success State
You know Gemini is wired correctly when:
- the gallery install succeeds
nmem statusreturns successfully- a new Gemini session exposes the Nowledge commands
save-threadimports a real Gemini session whilesave-handoffstays a separate summary path
Remote Mem
The recommended remote setup is:
nmem config client set url https://mem.example.com
nmem config client set api-key nmem_your_keyThat writes the shared local client config for this machine. nmem t save --from gemini-cli reads Gemini's local session files on the machine where Gemini is running, then uploads normalized thread messages to Mem. The remote Mem server does not need direct access to ~/.gemini.
What You Get
- Gemini-native context, hooks, commands, and skills
- Full session capture through
nmem t save --from gemini-cli - Direct
nmemcomposition whenever the built-in commands are too narrow - Clean local and remote auth through
nmem
Commands
/nowledge:read-working-memory/nowledge:search-memory <query>/nowledge:distill-memory/nowledge:save-thread/nowledge:save-handoff/nowledge:status
Thread Save And Handoff
Gemini supports two distinct save paths, and they should stay distinct:
save-threadimports the real Gemini session throughnmem t save --from gemini-clisave-handoffstores a concise resumable summary for restart and continuation
Manual Install
If you prefer installing from GitHub or a local checkout, use this path:
git clone https://github.com/nowledge-co/nowledge-mem-gemini-cli.git
cd nowledge-mem-gemini-cli
gemini extensions link .Gemini's official docs also support gemini extensions install <source> for GitHub or local sources, and gemini extensions link <path> for local development. For most users, the listed gallery install path above is the simplest choice.