cogito-mem (Cogi)

Name: cogito-mem (Cogi)
Author: meridian21lab

本地服务

meridian21lab.github.io记忆与知识01 周前更新

代码仓库访问官网

关于 cogito-mem (Cogi)

cogito-mem 是供 Claude Code 和其他 Agent 使用的本地长期记忆服务。它在本机保存对话原文及部分活动记录，并检索相关内容；保存消息不依赖云端或 AI 调用。

主要功能

01逐字保存对话
02记录命令与涉及的文件
03使用本地 SQLite 存储
04按提示词检索相关记忆
05保存前遮盖密钥并可暂停采集

适用场景

01回忆早期会话中的决定
02找回上下文窗口之外的信息
03将 Agent 记忆保留在本机

MCP 相关

本地 `cogi` MCP 服务向 Claude 提供 `memory_query` 和 `memory_append` 工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "meridian21lab-cogito-mem": {
      "command": "uvx",
      "args": [
        "cogito-mem"
      ],
      "env": {
        "COGITO_MEM_NAMESPACE": "<COGITO_MEM_NAMESPACE>"
      }
    }
  }
}

启动命令uvx cogito-mem

需要配置的环境变量

COGITO_MEM_NAMESPACEThe memory's name (default: <your username>-hollow).

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypicogito-mem0.2.1stdio

工具

收录的工具列表 · 更新于 6 天前

参数	类型	必填	说明
text	string	是	逐字保存的备注内容。
title	string	否	可选的简短标题，例如项目或主题。

详细介绍

cogito-mem

在自己的电脑上为 Claude Code 提供长期记忆。 松鼠 Cogi 会保存你和 Claude 交流的每条消息，并找回 Claude 忘记的内容。无需 API 密钥、云端服务，也不会调用 AI 来保存内容。

松鼠 Cogi：Claude 会忘记，Cogi 不会。

为什么值得一试

Claude 不再遗忘。 每条消息和回复都会逐字保存，并记录日期。当内容从上下文窗口中消失，或是发生在上周时，相关部分会在你下次发送提示词时重新出现。
它也会记住你做过什么。 你运行过的命令（以及是否失败）和操作过的文件都会被记录，但不会保存命令输出。
私密且免费。 所有内容都保存在电脑上的一个文件夹中。无需账户或 API 密钥，也不会调用 AI 来保存消息。任何内容都不会离开你的电脑。
经过测试。 在 LongMemEval-S 测试中，对于 500 个问题，Cogi 找到答案所在历史会话的排名有 99.0% 位于前五，且完全不涉及 AI 模型；截至 2026 年 10 月，其他已发布结果的本地记忆插件为 95.2–98.0%。在 LoCoMo 测试中，Cogi 返回的 1,000 个 token 能正确回答 74.7% 的问题，与重读完整对话（76.5%）相当。在笔记本电脑 CPU 上，搜索 1,000 万个 token 只需 26 毫秒。查看结果。

安装

你需要在 macOS 或 Linux 上安装 Claude Code 和 uv（Windows 支持仍处于实验阶段）。然后在终端中运行：

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

首次启动时会下载模型（310 MB，约需一分钟）。如需获取更新，请启用自动更新一次：/plugin → 市场 → cogito-mem → 启用自动更新。

分步指南 · Codex、Claude Desktop、Docker

试试看

告诉 Claude：我们把暂存服务器叫作“acorn”吧。
清除它的短期记忆：/clear
问它：我们把暂存服务器叫作什么？ Claude 会回答“acorn”：Cogi 把它找回来了。

Cogi 的运行、下载和存储内容

运行： 四个 Claude Code 钩子和一个名为 cogi 的 MCP 服务。每个组件都会运行 PyPI 上发布的 cogito-mem 软件包，版本与插件固定的版本完全一致（uvx cogito-mem==<version>）；插件的 uv.lock 列出了该版本和 numpy，以及对应的校验和。每次回复后和会话结束时，钩子都会从会话记录中保存新消息。会话开始时以及每次发送提示词时，钩子都会添加少量最相关的记忆（每条提示词最多 300 个 token）。MCP 服务向 Claude 提供两个工具：memory_query 和 memory_append；它们由一个仅在你的电脑上监听的轻量服务响应（127.0.0.1:7327）。
下载，一次性通过 HTTPS 完成： 通过 uv 从 PyPI 下载 cogito-mem 及其唯一依赖 numpy；从 llama.cpp 官方 GitHub 发布页下载 llama.cpp 的 llama-server（如果你已有该程序则跳过）；以及从 Hugging Face 下载 EmbeddingGemma 2 模型（310 MB）。此后，Cogi 不会进行网络调用。
存储： 你电脑上 ~/.cogito-mem/ 中的所有内容：你的消息，以及每轮操作内容的简短记录，存放在一个 SQLite 文件中。在保存任何内容之前，API 密钥、令牌、私钥和密码都会替换为 [redacted]；工具输出和文件内容永远不会保存。<private>…</private> 内的文本会跳过，设置 COGITO_MEM_CAPTURE=off 可暂停保存。
发送： 不会发送任何内容。无需账户，也没有分析或遥测。（可选的基准测试命令 cogito-mem eval locomo-qa 只有你自己运行时才会将基准测试问题发送给你为其设置的 LLM API，并使用你自己的密钥。）
彻底移除： 运行 claude plugin uninstall cogito-mem@cogito-mem，然后删除 ~/.cogito-mem。

包含源代码链接的全部文件、下载内容和连接：安装内容。

对比

	cogito-mem	claude-mem	Mem0 插件	cognee 插件	Supermemory 插件
用于存储消息的 AI 调用	无	每次工具调用都使用一个观察模型（默认使用 Claude 方案中的 Haiku）	在 Mem0 的服务上提取	使用你的大模型密钥或 `claude -p` 进行提取	在 Supermemory 的服务中
账户或 API 密钥	无	可选登录	Mem0 Platform API 密钥	大模型密钥或 Claude CLI	API 密钥或登录
记忆存储位置	你的电脑	你的电脑（可选云同步）	Mem0 云端	你的电脑（可选云端）	Supermemory 云端（提供本地模式）
返回内容	你的原话，附带日期	AI 撰写的观察记录	提取出的记忆	图谱事实和摘要	提取出的记忆
可搜索时间	同一轮内	观察模型运行后	批量处理（每 5 次对话）	下一次图谱运行后	后台保存完成后

将项目规则保存在 CLAUDE.md 中，让 Cogi 记住发生过的事。

了解更多


工作原理	收集、保存、查找：Cogi 存储什么，以及如何查找
结果 · 基准测试	数据，以及如何复现
API 和 MCP · 参考资料	HTTP、Python、终端、设置、常见问题、路线图
安装内容 · 隐私 · 条款	每个文件、下载项和连接；隐私和条款
开发	运行测试和评估