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.
Gemini is the cleanest CLI integration in the set: Gemini supplies the extension surface, and nmem supplies memory execution, thread import, handoff creation, and remote auth.
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
Open the Gemini CLI Extensions Gallery and search for Nowledge Mem.
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.
Remote Mem
The durable remote setup is nmem's own config file:
{
"apiUrl": "https://mem.example.com",
"apiKey": "nmem_your_key"
}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
- Real thread save 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.