memex

Name: memex
Author: iamtouchskyer

本地服务

github.com/iamtouchskyer记忆与知识1447 周前更新

代码仓库

关于 memex

memex 是面向 AI 编程 agent 的持久记忆系统，以带双向链接的 markdown 原子卡片保存 agent 学到的内容。它适用于希望 agent 跨会话延续知识的开发者，并可在多个客户端之间共享同一目录。

主要功能

01原子知识卡片，支持 [[双向链接]]
02无需向量数据库或 embedding
03多平台共享 ~/.memex/cards/ 目录
04可通过 Git 同步卡片
05提供可视化时间线与链接图视图

适用场景

01让 Claude Code 或 Cursor 跨会话回顾先前的结论
02在多台设备之间同步 agent 的记忆卡片
03用 Obsidian 等工具阅读和编辑卡片

MCP 相关

memex 以 MCP 服务形式运行，向 Cursor、Codex、Windsurf 等 MCP 客户端暴露 12 个工具，并在 Claude Code 中提供插件方式的集成。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "iamtouchskyer-memex": {
      "command": "npx",
      "args": [
        "-y",
        "@touchskyer/memex"
      ],
      "env": {
        "MEMEX_HOME": "<MEMEX_HOME>"
      }
    }
  }
}

启动命令npx -y @touchskyer/memex

需要配置的环境变量

MEMEX_HOMECustom data directory for memex cards (default: ~/.memex)

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

安装包

npm@touchskyer/memex0.1.8stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
limit	number	否	结果数量上限（默认值为 10）
query	string	否	搜索关键词。省略则列出所有卡片。

详细介绍

memex

为 AI 编码 Agent 提供持久记忆。Agent 会记住它在不同会话中学到的内容。

English | 中文 | 日本語 | 한국어 | Español

memex 时间线视图

English

每次 AI Agent 完成任务时，都会将心得保存为带有 [[双向链接]] 的原子化知识卡片。下次会话开始工作前，它会回忆相关卡片，基于已有知识继续推进，而不是从头开始。

无需向量数据库，也无需嵌入，只需使用 Agent（以及你）都能读取的 Markdown 文件。

支持的平台

平台	集成方式	体验
Claude Code	插件（钩子 + 技能）	最佳——自动回忆、斜杠命令、SessionStart 钩子
VS Code / Copilot	MCP 服务	12 个 MCP 工具，无需配置
Cursor	MCP 服务	12 个 MCP 工具，无需配置
Codex	MCP 服务	12 个 MCP 工具，无需配置
Windsurf	MCP 服务	12 个 MCP 工具，无需配置
Pi	扩展（自定义工具 + 钩子）	8 个工具、自动回忆钩子、斜杠命令
任意 MCP 客户端	MCP 服务	12 个 MCP 工具，无需配置

所有平台共用同一个 ~/.memex/cards/ 目录。在 Claude Code 中编写的卡片会立即出现在 Cursor、Codex 或任何其他客户端中。

前提条件

VS Code / Copilot：无前提条件——扩展已包含所有内容
Claude Code：无前提条件——插件会处理一切
Pi：需要 Node.js 18+ 和 npm install -g @touchskyer/memex
所有其他平台（Cursor、Codex、Windsurf 等）：需要 Node.js 18+

安装

步骤 1：将 memex 添加到编辑器

平台	命令
VS Code / Copilot	在 VS Code 扩展中搜索“memex”——安装即可，无需额外设置
Claude Code	`/plugin marketplace add iamtouchskyer/memex` 然后运行 `/plugin install memex@memex`
Claude Code（MCP 回退方案）	`npm install -g @touchskyer/memex && memex mcp-config --claude-code`
Cursor	先运行 `npm install -g @touchskyer/memex`，然后一键安装
Codex	`npm install -g @touchskyer/memex && codex mcp add memex -- memex mcp`
Pi	`npm install -g @touchskyer/memex && pi install npm:@touchskyer/memex`
Windsurf / 其他	运行 `npm install -g @touchskyer/memex`，然后添加 MCP 服务：命令为 `memex`，参数为 `["mcp"]`

**注意：**如果你在 VS Code 中使用 Claude Code，请按照 Claude Code 行操作，而不是“VS Code / Copilot”行。VS Code 扩展仅为 GitHub Copilot 提供服务；Claude Code 有自己的插件系统。

到此即可——无需额外设置。MCP 工具描述会告知 Agent 何时回忆和回顾。

升级

平台	方法
VS Code / Copilot	扩展会从市场自动更新
Claude Code	`/plugin uninstall memex` 然后运行 `/plugin install memex@memex`
Pi	运行 `npm update -g @touchskyer/memex`，并重新复制 `pi-extension/index.ts`
Cursor / Codex / Windsurf	运行 `npm update -g @touchskyer/memex`

跨平台共享

所有客户端都从同一个 ~/.memex/cards/ 目录读取和写入内容。使用 git 在设备间同步：

**前提条件：**自动创建需要 GitHub CLI（gh auth login）。也可以传入自己的 git 远程 URL 跳过此步骤，包括 GitLab 和可自托管的 GitLab 远程仓库。

memex sync --init                # auto-creates private memex-cards repo on GitHub
memex sync --init <repo-url>     # or specify your own repo URL (no gh/glab CLI needed)
memex sync on                    # enable auto-sync after every write
memex sync                       # manual sync
memex sync off                   # disable auto-sync

对于 GitLab，请先创建一个空的私有仓库，然后传入其 SSH 或 HTTPS 远程 URL。示例请参阅 GitLab 同步指南。

浏览你的记忆

memex serve

在 localhost:3939 打开所有卡片的可视化时间线。包含图谱视图，可探索双向链接。

如果你已设置同步，memex serve 会打开 memra.vercel.app——一个包含时间线、图谱视图和分享卡片功能的 Web UI。添加 --local 可强制使用本地 UI（适用于离线场景，或你不想将查询发送到第三方 Web 应用的情况）：

memex serve --local

图谱视图

CLI 参考

memex search [query]          # search cards (ranked), or guidance / --list
memex read <slug>             # read a card
memex write <slug>            # write a card (content via stdin)
memex links [slug]            # link graph stats, or one card's links
memex backlinks <slug>        # cards linking to <slug> via [[wiki-links]]
memex link <from> <to> <ctx>  # append an outbound [[wiki-link]] with context
memex archive <slug>          # move a card to the archive
memex organize                # analyze network: orphans, hubs, conflicts
memex serve                   # visual timeline UI (web)
memex sync                    # sync via git (--init / --status / on|off)
memex import [source]         # import memories from other tools (openclaw, ...)
memex mcp                     # start MCP server (stdio)
memex mcp-config              # configure MCP for Claude Code / other clients
memex doctor                  # check memex health and configuration
memex migrate                 # migrate configuration (e.g. --enable-nested)
memex flomo ...               # flomo integration: config / push / import

工作原理

基于 Niklas Luhmann 的 Zettelkasten 方法——这套系统帮助他用 90,000 张手写卡片写成了 70 本书：

原子化笔记——每张卡片只记录一个想法
用自己的话表达——促使你真正理解（费曼方法）
在上下文中建立链接——“这与 [[X]] 有关，因为……”而不只是添加标签
关键词索引——通往卡片网络的精心整理的入口

卡片以 Markdown 格式存储在 ~/.memex/cards/ 中。你可以在 Obsidian 中打开，用 vim 编辑，或在终端中使用 grep 搜索。你的记忆永远不会被锁定。

隐私防护

不要将真实的机密、凭据、令牌或机密文件的完整内容放入 memex 查询或卡片中。请改用抽象描述和脱敏示例。

Memex 会拒绝高置信度的原始机密，在保存前对 URL 中嵌入的凭据进行脱敏，并在显示输出中遮蔽 webhook/令牌化 URL。它无法隐藏 AI 客户端已在其对话记录中显示的不安全工具调用参数，因此请在调用工具前进行脱敏。

配置

可选设置放在 ~/.memex/.memexrc 中（JSON）：

{
  "nestedSlugs": true,
  "searchDirs": ["shared"],
  "experimental": {
    "agenticMemory": true
  }
}

键	类型	默认值	描述
`nestedSlugs`	boolean	`false`	允许 slug 中包含 `/`，以使用分层卡片路径
`searchDirs`	string[]	—	使用 `--all` 搜索的额外目录（除内置的 `cards/` 存储目录外）
`experimental.agenticMemory`	boolean	`false`	启用受 A-MEM 启发的 Agent 式记忆工作流（见下文）

实验性：Agent 式记忆

当 experimental.agenticMemory 为 true 时，Agent 可使用结构化记忆技能，该技能会引导它们依次执行：观察 → 起草原子卡片 → 丰富元数据 → 检索候选项 → 决策（创建/更新/跳过）→ 预览 → 写入 → 验证。

与默认的回顾/回溯工作流相比，这能生成质量更高的卡片，其中包含由 Agent 提出的 [[wikilinks]]（仅在检索候选项并由 Agent 审核后才会建议链接，绝不会仅凭关键词或嵌入相似度添加链接），并丰富元数据。此功能默认关闭，禁用时不会改变任何现有行为。

完整技能规范请参见 skills/memex-agentic-memory/SKILL.md，配置详情请参见 docs/ARCHITECTURE.md。

中文

AI 编程 Agent 的持久记忆系统。让你的 Agent 跨会话记住学到的知识。

每次 Agent 完成任务后，它会将洞察保存为带有 [[双向链接]] 的原子知识卡片。下次会话时，Agent 会先回顾相关卡片再开始工作——基于已有知识继续，而非从零开始。

无需向量数据库，无需 embedding——只是你和 Agent 都能读取的 Markdown 文件。

支持平台

平台	集成方式	体验
Claude Code	插件（hooks + skills）	最佳——自动回顾、斜杠命令、SessionStart hook
VS Code / Copilot	MCP 服务	12 个 MCP 工具，零配置
Cursor	MCP 服务	12 个 MCP 工具，零配置
Codex	MCP 服务	12 个 MCP 工具，零配置
Windsurf	MCP 服务	12 个 MCP 工具，零配置
Pi	扩展（自定义工具 + hooks）	8 个工具，自动回顾 hook，斜杠命令
任何 MCP 客户端	MCP 服务	12 个 MCP 工具，零配置

所有平台共享同一个 ~/.memex/cards/ 目录。在 Claude Code 中写的卡片，在 Cursor、Codex 或其他客户端中即刻可用。

前置要求

VS Code / Copilot：无需额外安装——扩展内置了所有依赖
Claude Code：无需额外安装——插件会自动处理
Pi：需要 Node.js 18+ 和 npm install -g @touchskyer/memex
其他平台（Cursor、Codex、Windsurf 等）：需要 Node.js 18+

安装

第一步：添加 memex 到编辑器

平台	命令
VS Code / Copilot	在 VS Code 扩展商店搜索 "memex"——安装即用，无需其他配置
Claude Code	`/plugin marketplace add iamtouchskyer/memex`，然后 `/plugin install memex@memex`
Claude Code（MCP 备选）	`npm install -g @touchskyer/memex && memex mcp-config --claude-code`
Cursor	先 `npm install -g @touchskyer/memex`，然后一键安装
Codex	`npm install -g @touchskyer/memex && codex mcp add memex -- memex mcp`
Pi	`npm install -g @touchskyer/memex && pi install npm:@touchskyer/memex`
Windsurf / 其他	`npm install -g @touchskyer/memex`，然后添加 MCP server：命令 `memex`，参数 `["mcp"]`

注意： 如果你在 VS Code 里使用 Claude Code，请按照 Claude Code 那一行操作，而非"VS Code / Copilot"。VS Code 扩展仅服务于 GitHub Copilot；Claude Code 有自己的 plugin 系统。

安装完成，无需额外配置。MCP 工具描述会自动告诉 agent 何时 recall 和 retro。

日本語

AIコーディングエージェントのための永続メモリシステム。エージェントがセッションをまたいで学んだことを記憶します。

エージェントがタスクを完了するたびに、[[双方向リンク]]付きのアトミックな知識カードとしてインサイトを保存します。次のセッションでは、作業開始前に関連カードを呼び出し、ゼロからではなく既存の知識の上に構築します。

ベクトルデータベースもembeddingも不要——エージェント（とあなた）が読めるmarkdownファイルだけです。

対応プラットフォーム

プラットフォーム	統合方式	体験
Claude Code	Plugin（hooks + skills）	最高——自動リコール、スラッシュコマンド、SessionStart hook
VS Code / Copilot	MCP Server	12 MCPツール、設定不要
Cursor	MCP Server	12 MCPツール、設定不要
Codex	MCP Server	12 MCPツール、設定不要
Windsurf	MCP Server	12 MCPツール、設定不要
Pi	Extension（カスタムツール + hooks）	8ツール、自動リコールhook、スラッシュコマンド
任意のMCPクライアント	MCP Server	12 MCPツール、設定不要

すべてのプラットフォームが同じ ~/.memex/cards/ ディレクトリを共有します。Claude Codeで書いたカードは、Cursor、Codex、その他のクライアントですぐに利用できます。

前提条件

VS Code / Copilot：前提条件なし——拡張機能がすべてをバンドル
Claude Code：前提条件なし——プラグインがすべてを処理
Pi：Node.js 18+ と npm install -g @touchskyer/memex が必要
その他のプラットフォーム（Cursor、Codex、Windsurf等）：Node.js 18+ が必要

インストール

ステップ1：エディタにmemexを追加

プラットフォーム	コマンド
VS Code / Copilot	VS Code 拡張機能で "memex" を検索——インストールするだけ、追加設定不要
Claude Code	`/plugin marketplace add iamtouchskyer/memex`、その後 `/plugin install memex@memex`
Claude Code（MCPフォールバック）	`npm install -g @touchskyer/memex && memex mcp-config --claude-code`
Cursor	まず `npm install -g @touchskyer/memex`、その後ワンクリックインストール
Codex	`npm install -g @touchskyer/memex && codex mcp add memex -- memex mcp`
Pi	`npm install -g @touchskyer/memex && pi install npm:@touchskyer/memex`
Windsurf / その他	`npm install -g @touchskyer/memex`、その後MCP serverを追加：コマンド `memex`、引数 `["mcp"]`

注意: VS Code内でClaude Codeを使用する場合は、「VS Code / Copilot」ではなく Claude Code の行に従ってください。VS Code拡張機能はGitHub Copilot専用です。Claude Codeには独自のプラグインシステムがあります。

インストール完了、追加設定は不要です。MCPツールの説明がエージェントにリコールとレトロのタイミングを自動的に教えます。

アップグレード

プラットフォーム	方法
VS Code / Copilot	拡張機能がマーケットプレイスから自動更新
Claude Code	`/plugin uninstall memex` → `/plugin install memex@memex`
Cursor / Codex / Windsurf	`npm update -g @touchskyer/memex`

한국어

AI 코딩 에이전트를 위한 영구 메모리 시스템. 에이전트가 세션을 넘어 학습한 내용을 기억합니다.

에이전트가 작업을 완료할 때마다 [[양방향 링크]]가 포함된 원자적 지식 카드로 인사이트를 저장합니다. 다음 세션에서는 작업 시작 전에 관련 카드를 불러와, 처음부터가 아닌 기존 지식 위에 구축합니다.

벡터 데이터베이스도 임베딩도 필요 없습니다 — 에이전트(와 당신)가 읽을 수 있는 markdown 파일뿐입니다.

支持的平台

平台	集成方式	使用体验
Claude Code	插件（hooks + skills）	最佳 — 自动召回、斜杠命令、SessionStart hook
VS Code / Copilot	MCP 服务	10 个 MCP 工具，无需配置
Cursor	MCP 服务	10 个 MCP 工具，无需配置
Codex	MCP 服务	10 个 MCP 工具，无需配置
Windsurf	MCP 服务	10 个 MCP 工具，无需配置
Pi	扩展（自定义工具 + hooks）	8 个工具、自动召回 hook、斜杠命令
所有 MCP 客户端	MCP 服务	10 个 MCP 工具，无需配置

所有平台共用同一个 ~/.memex/cards/ 目录。在 Claude Code 中编写的卡片可立即在 Cursor、Codex 或其他客户端中使用。

前提条件

VS Code / Copilot：无前提条件 — 扩展包含所有内容
Claude Code：无前提条件 — 插件会处理一切
Pi：需要 Node.js 18+ 和 npm install -g @touchskyer/memex
其他平台（Cursor、Codex、Windsurf 等）：需要 Node.js 18+

安装

第 1 步：将 memex 添加到编辑器

平台	命令
VS Code / Copilot	在 VS Code 扩展中搜索“memex” — 安装即可，无需额外配置
Claude Code	运行 `/plugin marketplace add iamtouchskyer/memex`，然后运行 `/plugin install memex@memex`
Claude Code（MCP 替代方式）	`npm install -g @touchskyer/memex && memex mcp-config --claude-code`
Cursor	先运行 `npm install -g @touchskyer/memex`，然后使用一键安装
Codex	`npm install -g @touchskyer/memex && codex mcp add memex -- memex mcp`
Pi	`npm install -g @touchskyer/memex && pi install npm:@touchskyer/memex`
Windsurf / 其他	运行 `npm install -g @touchskyer/memex`，然后添加 MCP 服务：命令为 `memex`，参数为 `["mcp"]`

注意： 如果在 VS Code 中使用 Claude Code，请按照 Claude Code 行操作，而不是“VS Code / Copilot”行。VS Code 扩展仅适用于 GitHub Copilot，Claude Code 使用自己的插件系统。

安装完成后无需额外配置。MCP 工具说明会自动告知 Agent 何时召回以及何时进行回顾。

升级

平台	方法
VS Code / Copilot	扩展会从市场自动更新
Claude Code	`/plugin uninstall memex` → `/plugin install memex@memex`
Cursor / Codex / Windsurf	`npm update -g @touchskyer/memex`

西班牙语

为 AI 编码 Agent 提供持久记忆。你的 Agent 会记住它在不同会话中学到的内容。

每当 AI Agent 完成一项任务，就会将知识保存为带有 [[双向链接]] 的原子卡片。在下一个会话中，它会在开始前检索相关卡片，在已有知识的基础上继续，而不是从头开始。

无需向量数据库，无需嵌入 — 只有 Agent（以及你）都能读取的 Markdown 文件。

支持的平台

平台	集成方式	使用体验
Claude Code	插件（hooks + skills）	最佳 — 自动召回、斜杠命令、SessionStart hook
VS Code / Copilot	MCP 服务	12 个 MCP 工具，无需配置
Cursor	MCP 服务	12 个 MCP 工具，无需配置
Codex	MCP 服务	12 个 MCP 工具，无需配置
Windsurf	MCP 服务	12 个 MCP 工具，无需配置
Pi	扩展（自定义工具 + hooks）	8 个工具、自动召回 hook、斜杠命令
任何 MCP 客户端	MCP 服务	12 个 MCP 工具，无需配置

所有平台共用同一个 ~/.memex/cards/ 目录。在 Claude Code 中编写的卡片可立即在 Cursor、Codex 或任何其他客户端中使用。

前提条件

VS Code / Copilot：无前提条件 — 扩展包含所有内容
Claude Code：无前提条件 — 插件会处理一切
Pi：需要 Node.js 18+ 和 npm install -g @touchskyer/memex
其他平台（Cursor、Codex、Windsurf 等）：需要 Node.js 18+

安装

第 1 步：将 memex 添加到你的编辑器

平台	命令
VS Code / Copilot	在 VS Code 扩展中搜索“memex”——安装即可，无需额外配置
Claude Code	`/plugin marketplace add iamtouchskyer/memex`，然后运行 `/plugin install memex@memex`
Claude Code（备用 MCP）	`npm install -g @touchskyer/memex && memex mcp-config --claude-code`
Cursor	先运行 `npm install -g @touchskyer/memex`，然后一键安装
Codex	`npm install -g @touchskyer/memex && codex mcp add memex -- memex mcp`
Pi	`npm install -g @touchskyer/memex && pi install npm:@touchskyer/memex`
Windsurf / 其他	运行 `npm install -g @touchskyer/memex`，然后添加 MCP 服务：命令为 `memex`，参数为 `["mcp"]`

注意： 如果你在 VS Code 中使用 Claude Code，请按照 Claude Code 一行操作，而不是“VS Code / Copilot”。VS Code 扩展仅适用于 GitHub Copilot；Claude Code 有自己的插件系统。

安装完成后，无需额外配置。MCP 工具的描述会自动告诉你的 Agent 何时进行回忆和复盘。

更新

平台	方法
VS Code / Copilot	扩展会从市场自动更新
Claude Code	`/plugin uninstall memex` → `/plugin install memex@memex`
Cursor / Codex / Windsurf	`npm update -g @touchskyer/memex`

社区

在使用 memex？欢迎在讨论 → 分享与交流分享你的配置。问题请发到问答。功能创意请发到创意。

许可证

MIT

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

memex

关于 memex

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

memex

English

支持的平台

前提条件

安装

升级

跨平台共享

浏览你的记忆

CLI 参考

工作原理

隐私防护

配置

实验性：Agent 式记忆

中文

支持平台

前置要求

安装

日本語

対応プラットフォーム

前提条件

インストール

アップグレード

한국어

支持的平台

前提条件

安装

升级

西班牙语

支持的平台

前提条件

安装

更新

社区

许可证

评论

第一次接触 MCP？

MCP（Model Context Protocol）是什么？

MCP 服务和客户端有什么区别？

本地服务与远程服务怎么选？

如何在 Claude、Cursor 等客户端中安装服务？

收录的项目经过审核吗？“认证”标识代表什么？

我维护的项目已被收录，怎样认领？