Agentos Memory

AgentOS内存——给Claude代码一个永久内存

Claude Code在会话之间会忘记一切。这解决了这个问题。

AgentOS Memory是一个MCP（模型上下文协议）服务器，它为Claude Code提供持久、可搜索的内存——在每个会话、每个项目中，永远如此。它在本地运行，将所有内容存储在SQLite中，不需要任何外部服务。

curl -fsSL https://raw.githubusercontent.com/joemc1470/agentos-memory/main/install.sh | bash

______________________________________________________________________

为什么？

每次启动Claude Code会话时，您都是从零开始的。你重新解释你的堆栈。重新描述你的偏好。重新讲述你三周前做出的决定。今天是土拨鼠日，但对于你的人工智能助手来说。

AgentOS内存为Claude Code提供了一个实际的内存。存储事实。稍后搜索它们。导入您的ChatGPT历史记录。它在会话、项目甚至机器之间持续存在（如果同步SQLite文件）。

______________________________________________________________________

特性

• 🧠 持久内存 --在所有Claude Code会话中存储事实、决策和上下文
• 🔍 全文搜索 -SQLite FTS5在没有矢量数据库或API的情况下为您提供快速、相关的结果
• 📔 会话日志 --日志对话转向；再也不会因为压缩而失去上下文
• 🕸️ 知识图谱 --店铺结构化主题→谓语→客观事实
• 📥 导入您的历史记录 --从ChatGPT导出、Claude文件或任何标记中引入内存
• ⚡ 零依赖 --仅限SQLite。没有Postgres，没有Redis，没有API密钥，没有云
• 🔌 独立工作或与AgentOS配合使用 --单独使用，或作为完整AgentOS网格的一部分使用
• 🏃 即时安装 --一个 curl | bash，适用于macOS和Linux

______________________________________________________________________

安装

curl -fsSL https://raw.githubusercontent.com/joemc1470/agentos-memory/main/install.sh | bash

安装程序：

1. 检查 bun （如果缺少，则安装）
2. 将服务器下载到 ~/.agentos-memory/
3. 跑 bun install
4. 在Claude Code注册为用户级MCP服务器

安装后，启动任何Claude Code会话，工具就会自动可用。

手动安装 （如果你愿意的话）：

git clone https://github.com/joemc1470/agentos-memory.git ~/.agentos-memory
cd ~/.agentos-memory && bun install
claude mcp add -e AGENTOS_MODE=standalone -s user agentos-memory -- bun ~/.agentos-memory/src/index.ts

______________________________________________________________________

快速开始

安装后，打开Claude Code并尝试：

Use memory_add to remember: I prefer TypeScript over Python, always use strict mode

结束会话。打开一个新的：

Use memory_search to find my language preferences

每次克劳德都会找到的。

______________________________________________________________________

建筑

Claude Code Session
       │
       │ MCP (stdio)
       ▼
┌──────────────────────────────────┐
│      AgentOS Memory Server       │
│  ┌────────────┐ ┌─────────────┐  │
│  │  11 Tools  │ │   Config    │  │
│  └────────────┘ └─────────────┘  │
│          │                       │
│          ▼                       │
│  ┌────────────────────────────┐  │
│  │   Standalone Mode          │  │
│  │   SQLite + FTS5            │  │
│  │  ~/.agentos-memory/data/   │  │
│  │  ├── memories.db           │  │
│  │  │   ├── memories (FTS5)   │  │
│  │  │   ├── journal  (FTS5)   │  │
│  │  │   └── facts    (FTS5)   │  │
│  └────────────────────────────┘  │
│          OR                      │
│  ┌────────────────────────────┐  │
│  │   Full AgentOS Mode        │  │
│  │   Mem0 + Qdrant + KG       │  │
│  │   3-tier memory search     │  │
│  │   Context Engine           │  │
│  └────────────────────────────┘  │
└──────────────────────────────────┘

______________________________________________________________________

工具参考

🧠 记忆

用途：

memory_add: "The production database is PostgreSQL 15 on AWS RDS, us-east-1"
memory_search: "production database"
→ returns the fact above in future sessions

📔 期刊

日记是你谈话的保险。当LCM压缩你的上下文时，期刊就拥有了一切。

🏛️ 记忆宫殿

🕸️ 知识图谱

例子：

kg_add_fact: subject="alice", predicate="prefers", object="dark mode always"
kg_add_fact: subject="project-x", predicate="uses", object="React + TypeScript"

🔭 上下文引擎

🔧 系统

📥 导入

______________________________________________________________________

导入您的记忆

来自ChatGPT

1. 转到ChatGPT→ 设置→ 数据控制→ 导出数据
2. 下载并解压缩导出
3. 在克劳德代码中：

Use memory_import with source="chatgpt" and file_path="/path/to/conversations.json"

每一次对话都变成了可搜索的记忆。

来自克劳德记忆文件

Use memory_import with source="claude" and file_path="default"

读取 ~/.claude/memory/*.md --每个标题/部分都成为记忆。

从任何Markdown文件

Use memory_import with source="markdown" and file_path="/path/to/notes.md"

按标题拆分。每个部分=一个内存。

从纯文本

Use memory_import with source="text" and file_path="/path/to/notes.txt"

用双换行符分隔。每段=一段记忆。

______________________________________________________________________

配置

通过环境变量设置（in .mcp.json 或传递给安装程序）：

更改您的用户ID （对团队有用）：

claude mcp add \
  -e AGENTOS_MODE=standalone \
  -e AGENTOS_USER_ID=yourname \
  -s user agentos-memory \
  -- bun ~/.agentos-memory/src/index.ts

______________________________________________________________________

独立与全代理操作系统

独立模式(AGENTOS_MODE=standalone)

适用于 零外部服务.所有存储在 ~/.agentos-memory/data/memories.db.

• ✅ 没有API密钥
• ✅ 无需互联网
• ✅ 适用于任何有面包的机器
• ✅ SQLite FTS5全文搜索
• ✅ 所有11个工具都工作
• ⚠️ 搜索基于关键字（无语义/矢量搜索）
• ⚠️ 无多代理同步

完全代理操作系统模式(AGENTOS_MODE=full)

需要跑步 AgentOS 安装。

• ✅ 三层内存搜索（本地缓存→ Mem0主→ 备份）
• ✅ 通过Qdrant进行矢量/语义搜索
• ✅ 全上下文引擎（启动数据包、任务上下文）
• ✅ 知识图（Chloe KG节点）
• ✅ 跨网格的多代理内存同步
• ✅ 带有自动分类功能的记忆宫
• ⚠️ 需要在本地运行AgentOS

______________________________________________________________________

数据位置

~/.agentos-memory/
├── src/              ← MCP server source
├── data/
│   └── memories.db   ← Your memory database (back this up!)
└── node_modules/

备份你的记忆：

cp ~/.agentos-memory/data/memories.db ~/memories-backup-$(date +%Y%m%d).db

跨机器同步：

# Any file sync that handles SQLite will work:
rsync -av ~/.agentos-memory/data/memories.db user@other-machine:~/.agentos-memory/data/

______________________________________________________________________

手动测试

验证服务器在没有Claude Code的情况下是否正常工作：

# List all tools
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \
  | AGENTOS_MODE=standalone bun ~/.agentos-memory/src/index.ts 2>/dev/null \
  | jq '.result.tools[].name'

# Add a memory
echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"memory_add","arguments":{"text":"test memory"}}}' \
  | AGENTOS_MODE=standalone bun ~/.agentos-memory/src/index.ts 2>/dev/null

# Check status
echo '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"agent_status","arguments":{}}}' \
  | AGENTOS_MODE=standalone bun ~/.agentos-memory/src/index.ts 2>/dev/null | jq .

______________________________________________________________________

卸载

curl -fsSL https://raw.githubusercontent.com/joemc1470/agentos-memory/main/uninstall.sh | bash

或手动：

claude mcp remove agentos-memory -s user
rm -rf ~/.agentos-memory

______________________________________________________________________

路线图

• \[ \] 托管层 --云同步+语义搜索，无需运行自己的基础设施
• \[ \] Web用户界面 --浏览和管理您的回忆 localhost:8765
• \[ \] CLAUDE.md自动注入 --自动将相关内存注入会话上下文
• \[ \] 向量搜索 --通过以下方式进行可选的本地嵌入 llama.cpp 或 Ollama
• \[ \] 记忆衰退 --自动过期陈旧记忆，增强频繁访问的记忆
• \[ \] 团队同步 --跨Claude Code实例共享内存命名空间

______________________________________________________________________

贡献

欢迎在 .

# Dev setup
git clone https://github.com/joemc1470/agentos-memory.git
cd agentos-memory
bun install

# Test the server
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \
  | AGENTOS_MODE=standalone bun src/index.ts 2>/dev/null | jq .

堆栈： TypeScript+Bun+SQLite（Bun:SQLite）+MCP SDK

______________________________________________________________________

许可证

麻省理工学院——随心所欲。

______________________________________________________________________

*部分 AgentOS 项目——一个持久的、多代理的人工智能基础设施层。*