Which agent do you use?
Pick yours. See just the steps you need.
Install your agent first. Choose Worker in the installer for memory on this computer. Choose your note-writing service and complete its account or key setup.
npx memindex install --ide claude-code
npx memindex doctorIn a terminal, the installer asks how MemIndex should write its notes. See Install for the shared setup steps.
The installer enables the MemIndex plugin in Claude Code. Start a new Claude Code session after setup.
Let an agent or script do it
If Claude Code, another agent or a script runs the install, use the command that never asks a question:
npx memindex install --ide claude-code --yes
It uses your Anthropic plan to write notes, keeps memory on this computer, starts the background service and waits until it answers. If the service cannot start, the command exits with an error and tells you which command to run.
What it changes
- Copies the MemIndex plugin into
~/.claude/pluginsand lists it inknown_marketplaces.jsonandinstalled_plugins.jsonthere. - Turns the plugin on in
~/.claude/settings.json, leaving your other settings alone. Native Claude Code memory stays on unless you pass--disable-auto-memory. - Creates
~/.memindexfor your notes, settings and the viewer sign-in key. - Starts the background service.
Take it out
npx memindex uninstall
This stops the service and removes everything above except ~/.memindex, so your notes are kept.
Your next session starts here.
Keep the useful parts of your work for the next session.
A little memory. A continuing thought.
- During a session
You make a choice
“Keep the smaller image. It loads faster.”
- Saved as memory
The reason stays
MemIndex turns activity into a short note.
- The next day
Your agent recalls it
“We chose the smaller image for speed.”
An example. Capture and recall depend on your agent’s integration.
MemIndex turns supported agent activity into short notes. Later sessions can use those notes or search for earlier work. What gets captured depends on your agent.
What you need
- Your agentA supported agent, already installed.
- Node.js 20.12 or newerThe installer checks for Bun and uv. Windows also needs Git Bash.
- A way to write notesYour model account or API key for local note-writing. Model usage may have a cost. Hosting plans include note-writing.
Make yourself at home
Your agent, your guide
Each agent has its own guide in the navigation. A search connection can read existing memory. It does not automatically record conversations. Check your guide for capture, context and setup limits.