English Français العربية

cogito-mem (Cogi)

Registre officiel Outils de développement

Local long-term memory for Claude Code and other agents: every message kept word for word, no cloud.

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

PYPI package cogito-mem
Claude Code 
claude mcp add cogito-mem-cogi -e 'COGITO_MEM_NAMESPACE=<COGITO_MEM_NAMESPACE>' -- uvx cogito-mem==0.2.1 mcp
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "cogito-mem-cogi": {
            "command": "uvx",
            "args": [
                "cogito-mem==0.2.1",
                "mcp"
            ],
            "env": {
                "COGITO_MEM_NAMESPACE": "<COGITO_MEM_NAMESPACE>"
            }
        }
    }
}

Variables d'environnement

  • COGITO_MEM_NAMESPACE The memory's name (default: <your username>-hollow).

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. cogito-mem
  2. Why try it
  3. Install
  4. Try it
  5. What Cogi runs, downloads and stores
  6. How it compares
  7. Learn more
  8. License

cogito-mem

Long-term memory for Claude Code, on your own machine. Cogi the squirrel keeps every message you and Claude exchange, and brings back what Claude forgot. No API key, no cloud, no AI calls to store.

Why try it

  • Claude stops forgetting. Every message and reply is kept word for word, with its date. When something has dropped out of the context window, or happened last week, the relevant part comes back with your next prompt.
  • It remembers what you did, too. The commands you ran (and whether they failed) and the files you touched, without their output.
  • Private and free. One folder on your computer. No account, no API key, no AI calls to save a message. Nothing leaves your machine.
  • Tested. On LongMemEval-S, the past session holding the answer is among the first five Cogi finds for 99.0% of 500 questions, with no AI model involved; other local memory plugins published 95.2–98.0% as of October 2026. On LoCoMo, the 1,000 tokens Cogi hands back answer 74.7% of questions right, level with rereading the whole conversation (76.5%). A search over 10 million tokens takes 26 ms on a laptop CPU. See the results.

Install

You need Claude Code and uv, on macOS or Linux (Windows is experimental). Then, in a terminal:

claude plugin install cogito-mem --marketplace meridian21lab/cogito-mem

The first start downloads the model (310 MB, about a minute). To get updates, turn on auto-update once: /plugin → Marketplaces → cogito-mem → Enable auto-update.

Step-by-step guide · Codex, Claude Desktop, Docker

Try it

  1. Tell Claude: Let's call the staging server "acorn".
  2. Clear its short-term memory: /clear
  3. Ask: What did we call the staging server? Claude answers "acorn": Cogi brought it back.

What Cogi runs, downloads and stores

  • Runs: four Claude Code hooks and one MCP server, cogi. Each runs the released cogito-mem package from PyPI at the exact version the plugin pins (uvx cogito-mem==<version>); the plugin's uv.lock lists that release and numpy with their checksums. After each reply and at the end of a session, the hooks save the new messages from the session's transcript. At the start of a session and with each prompt, they add the few most relevant memories (at most 300 tokens per prompt). The MCP server gives Claude two tools, memory_query and memory_append, answered by a small service that listens on your computer only (127.0.0.1:7327).
  • Downloads, once, over HTTPS: cogito-mem and its one dependency, numpy, from PyPI (by uv); llama.cpp's llama-server from llama.cpp's official GitHub releases (skipped if you already have it); and the EmbeddingGemma 2 model (310 MB) from Hugging Face. After that, Cogi makes no network calls.
  • Stores: everything in ~/.cogito-mem/ on your computer: your messages, and a short note of what each turn did, in one SQLite file. API keys, tokens, private keys and passwords are replaced with [redacted] before anything is saved; tool output and file contents are never saved. Text inside <private>…</private> is skipped, and COGITO_MEM_CAPTURE=off pauses saving.
  • Sends: nothing. No account, no analytics, no telemetry. (The optional benchmark command, cogito-mem eval locomo-qa, which only you would run, sends benchmark questions to the LLM API you set up for it, with your own key.)
  • Removes cleanly: claude plugin uninstall cogito-mem@cogito-mem, then delete ~/.cogito-mem.

Every file, download and connection, with links to the source: What you install.

How it compares

cogito-memclaude-memMem0 plugincognee pluginSupermemory plugin
AI calls to store a messagenonean observer model per tool call (Haiku on your Claude plan by default)extraction on Mem0's serversextraction with your LLM key or claude -pin Supermemory's service
Account or API keynoneoptional sign-inMem0 Platform API keyan LLM key or the Claude CLIAPI key or login
Where your memory livesyour computeryour computer (cloud sync optional)Mem0's cloudyour computer (cloud optional)Supermemory's cloud (local mode available)
What comes backyour exact words, with datesAI-written observationsextracted memoriesgraph facts and summariesextracted memories
Searchable afterthe same turnthe observer's runa batch (every 5 exchanges)the next graph runthe background save

Keep your project's rules in CLAUDE.md, and let Cogi remember what happened.

Learn more
How it worksCollect, keep, find: what Cogi stores and how it finds it
Results · BenchmarksThe numbers, and how to reproduce them
API & MCP · ReferenceHTTP, Python, terminal, settings, FAQ, roadmap
What you install · Privacy · TermsEvery file, download and connection; privacy and terms
DevelopmentRunning the tests and the evaluations

Early access. v0.2 is new, built and tested (over 200 tests), and still being measured. Feedback and issues are very welcome.

License

MIT

Questions fréquentes

Qu'est-ce que cogito-mem (Cogi) ?

Local long-term memory for Claude Code and other agents: every message kept word for word, no cloud.

Comment installer cogito-mem (Cogi) ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add cogito-mem-cogi -e 'COGITO_MEM_NAMESPACE=<COGITO_MEM_NAMESPACE>' -- uvx cogito-mem==0.2.1 mcp. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour cogito-mem (Cogi) ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

cogito-mem (Cogi) est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient cogito-mem (Cogi) ?

Il est publié par meridian21lab. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.