English Français العربية

cogito-mem (Cogi)

السجل الرسمي أدوات المطورين

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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
إعداد 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>"
            }
        }
    }
}

متغيرات البيئة

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

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو cogito-mem (Cogi)؟

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

كيف أثبّت cogito-mem (Cogi)؟

يعمل على جهازك. في Claude Code: claude mcp add cogito-mem-cogi -e 'COGITO_MEM_NAMESPACE=<COGITO_MEM_NAMESPACE>' -- uvx cogito-mem==0.2.1 mcp. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج cogito-mem (Cogi) إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل cogito-mem (Cogi) مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون cogito-mem (Cogi)؟

ينشره meridian21lab. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.