Stateless Agent Memory Engine (SAME)

SAME — 面向 AI 编码 Agent 的持久记忆

你的 AI 会忘记所有会话内容。SAME 能解决这个问题。

SAME 为每款 AI 编码工具提供持久记忆。Claude Code、Cursor、Windsurf、Codex CLI、Gemini CLI——一层适用于所有工具的记忆层。它会为你的 Markdown 笔记建立索引，自动呈现相关上下文，并记录决策和交接内容，让 AI 能从上次中断的地方继续。

单个二进制文件。完全本地运行。无云端服务。无遥测。支持 Mac、Linux、Windows 和 Raspberry Pi。

安装

# macOS / Linux
curl -fsSL https://statelessagent.com/install.sh | bash

# Windows (PowerShell)
irm https://statelessagent.com/install.ps1 | iex

也可通过 npm 安装（适用于所有平台）：npm install -g @sgx-labs/same

通过 npm 安装？ 使用 npx same@latest 或 npm update -g @sgx-labs/same 更新。

查看运行效果

same demo

Indexing 5 sample notes...
Searching: "authentication decision"

  1. decisions/auth-strategy.md (score: 0.94)
     "We chose JWT with refresh tokens for..."

  2. notes/api-security.md (score: 0.87)
     "Auth middleware validates tokens at..."

Asking: "what did we decide about authentication?"

  Based on your notes, you decided to use JWT with refresh
  tokens (decisions/auth-strategy.md). The API middleware
  validates tokens at the gateway level (notes/api-security.md).

No accounts. No API keys. Everything runs locally.

快速开始

# 1. Point SAME at your project
cd ~/my-project && same init

# 2. Test search
same search "authentication decision"

# 3. Done. Your AI now has memory.
# Start Claude Code, Cursor, or any MCP client.

same init 会自动设置钩子和 MCP 工具。每次会话开始时，AI 都能获取相关上下文。

主要功能

• 让 AI 记住一切——决策、交接内容和上下文会在不同会话间保留。关闭终端、切换项目、明天再回来，都不会丢失任何内容。

• 记忆完整性——追踪来源（笔记的出处）、检测源文件变化并标记过时知识。过时笔记在搜索中的排名会自动降低。same health 会显示整个知识库的可信状态。

• 双层记忆——通过大模型从笔记中提取原子事实。事实可单独搜索，并能提升源笔记在搜索结果中的排名。即使事实埋藏在无关对话中，也能呈现正确答案。

• 可流式传输的 HTTP 传输——same web --mcp 可启用带有 Bearer 令牌身份验证的 HTTP MCP 端点。可从 Open WebUI、LobeChat 或任何 HTTP MCP 客户端连接，无需 stdio。

• 兼容你的工具——提供 19 个 MCP 工具，适用于 Claude Code、Cursor、Windsurf 或任何 MCP 客户端。无需离开编辑器，即可搜索、保存决策和创建交接记录。

• 团队安全协作——多个 AI Agent 可在同一代码库中工作，互不干扰。内置文件认领、推送保护和归属追踪。

• 即时获取专业知识——提供 17 个预构建知识库，包含 870 多条精选笔记。一条命令即可安装。AI 几秒内即可获取领域知识。

• 互联知识——查看决策、文件和笔记之间的关联。询问“哪些内容依赖于此？”即可获得真实答案。由 SQLite 提供支持。

安全与团队协作

SAME 内置个人身份信息（PII）扫描和推送保护功能：

• PII 扫描——提交前钩子会在电子邮件、API 密钥、机密和个人数据进入 Git 前检测这些内容。支持可配置的阻止列表，并提供误报审核工作流。
• 推送保护——多 Agent 文件认领可防止 AI Agent 覆盖彼此的工作。提供带归属追踪的建议性锁定。
• 审计日志——每次防护扫描、每次允许操作和每次覆盖操作都会记录日志。
• 隐私等级——_PRIVATE/ 永远不会被编入索引。research/ 会编入索引，但永远不会提交。你的笔记，由你定规则。

same guard settings set push-protect on    # enable push protection
same guard scan                            # run PII scan manually

工作原理

Your Notes (.md)  -->  Embeddings  -->  SQLite  -->  Your AI Tool
                       (local or        (search      (Claude Code,
                        cloud)           + rank)      Cursor, etc.)

你的 Markdown 笔记会经过嵌入并存储在 SQLite 中。AI 启动会话时，SAME 会通过钩子或 MCP 提供相关上下文。决策会被提取出来，交接内容会自动生成。下一次会话会从上次停止的地方继续。

没有 Ollama？没问题。 SAME 无需任何外部依赖即可运行，并使用关键词搜索（SQLite FTS5）。之后添加 Ollama，再运行 same reindex 即可立即升级为语义搜索。

为什么选择 SAME

数据表现

添加到你的 AI 工具

Claude Code（推荐）

same init    # installs 6 hooks + MCP automatically

Cursor / Windsurf / 任意 MCP 客户端

添加到你的 MCP 配置中（.mcp.json、Cursor 设置等）：

{
  "mcpServers": {
    "same": {
      "command": "npx",
      "args": ["-y", "@sgx-labs/same", "mcp", "--vault", "/path/to/your/notes"]
    }
  }
}

立即提供 19 个 MCP 工具。无需 Ollama 也能运行（关键词回退）。

在 Claude Code 和 Cursor 之间切换，上下文不会丢失。你的记忆会随你而行。

工具兼容性

Claude Code 可通过钩子实现完整的自动交接。Cursor、Windsurf、Codex CLI、Gemini CLI 可完整访问 MCP 工具（搜索、保存、决策、图谱），但需要手动触发交接。我们正在为更多编辑器开发自动交接支持。

MCP 服务

SeedVaults

预构建的知识库。一条命令即可安装。

same seed list                              # browse available seeds
same seed install claude-code-power-user    # install one

还有 9 个。 在 GitHub 上浏览全部 17 个种子库。

隐私

所有数据都保留在你的机器上。SAME 创建了三级隐私结构：

无遥测。无云服务。已阻止路径遍历。配置文件仅允许所有者访问。

更多

[vault]
path = "/home/user/notes"
handoff_dir = "sessions"
decision_log = "decisions.md"

[embedding]
provider = "ollama"           # "ollama", "openai", "openai-compatible", or "none"
model = "nomic-embed-text"

[memory]
max_token_budget = 800
max_results = 2

# Docker
git clone --depth 1 https://github.com/sgx-labs/statelessagent.git
cd statelessagent && docker build -t same .

# Build from source (requires Go 1.25+)
git clone --depth 1 https://github.com/sgx-labs/statelessagent.git
cd statelessagent && make install

链接

• 网站
• Telegram Bot 插件
• SeedVaults
• Discord
• 更新日志

参与贡献

欢迎贡献。提交问题或发起讨论。

git clone https://github.com/sgx-labs/statelessagent.git
cd statelessagent
make build && make test

安全相关报告请参阅 SECURITY.md。

支持

请我喝杯咖啡 | GitHub Sponsors

许可证

BSL 1.1。可免费用于个人、教育、爱好、研究和评估用途。将于 2030-02-02 转为 Apache 2.0。请参阅 LICENSE。