IWE (iwe.md)

Name: IWE (iwe.md)
Author: iwe-org

本地服务

iwe.md记忆与知识1.8k今天更新

代码仓库访问官网

关于 IWE (iwe.md)

IWE 是供用户与 AI Agent 共同维护项目记忆的 Markdown 知识库。笔记保存在本地文件中，可通过应用、编辑器、CLI 和连接 MCP 的 Agent 使用。

主要功能

01互相关联的 Markdown 笔记
02人和 Agent 共享记忆
03反向链接与链接自动补全
04CLI 搜索和管理笔记
05支持兼容 MCP 的 Agent

适用场景

01保存项目决策供后续会话使用
02搜索和整理项目笔记
03直接检查和修改 Agent 写入的记忆

MCP 相关

`iwec` MCP 服务让兼容的 Agent 在指定笔记目录中读取、写入和整理笔记。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "iwe-org-iwe": {
      "command": "npx",
      "args": [
        "-y",
        "@iwe-org/mcp"
      ]
    }
  }
}

启动命令npx -y @iwe-org/mcp

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

安装包

npm@iwe-org/mcp0.29.1stdio

工具

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

参数	类型	必填	说明
to	array	否	要附加到的已配置附加操作（例如 'today'）。传入一个或多个操作名称；源文档会附加到每个解析出的目标中。
key	string\|null	否	要作为块引用附加到目标的文档键
list	boolean\|null	否	列出可用的附加操作，而不执行操作。默认值：false
dry_run	boolean\|null	否	预览更改但不应用。默认值：false

详细介绍

IWE：你和 AI Agent 一起协作的 Markdown 知识库

English · 简体中文 · 한국어

你的笔记就是 Agent 的记忆。IWE 是你们共同协作的地方。

iwe.md · Download for Mac · 文档 · Reddit

太多 AI 对话都从零开始。你解释项目、决策和理由，接着发现自己在下一次会话中又得把这些全都解释一遍。你自己的笔记放在别处，Agent 无法访问。

更糟的是，Agent 会在自己的内部记忆中“记住”某些内容，但你很难查看它保存了什么，或纠正它记错的内容。而且，这些记忆无法随你带到其他协作的 Agent 中。

IWE 为你和 AI Agent 在项目中提供一个共同协作的空间：一个由相互关联的 Markdown 文档组成的文件夹，包含规格说明、计划、决策等内容。把自己的想法保存在这里，让 Agent 帮你记录你们共同了解到的内容，并随着工作推进，随时回到这些上下文中。你可以亲自阅读、编辑和整理这些文档，而且它们始终归你所有。

选择你的工作方式

IWE 提供四种工作方式。你可以自由搭配，适应每天的工作：

工具	使用方式
iWe for Mac	在原生应用中编写和浏览，并连接现有的 Claude/Codex Agent。
你自己的编辑器	继续使用 Neovim、Helix、VS Code 或 Zed，并享用笔记导航、反向链接和自动补全。
CLI	在终端或脚本中搜索和管理笔记。
Claude/Codex	通过对话，让 Agent 在你工作时读取、编写和整理记忆。

这四种方式使用的是同一批 Markdown 文档。你可以在编辑器中起草规格说明，用 Claude/Codex 进一步完善，在 iWe 应用中浏览，或通过 CLI 搜索。你可以按喜好任意组合；每种工具也都可以独立使用。

自备 AI。 IWE CLI 和 iWe Mac 应用都不包含 AI 模型。两者都可以独立作为笔记工具使用。需要 AI 协助时，请使用现有的 Claude/Codex Agent——在终端中使用，或直接在 Mac 应用中使用。

计划 · 图表 · 技术文档 · 发布——点击截图，在 iwe.md 上查看 iWe 应用的实际效果。

为什么选择 IWE

共享上下文。 你的 Agent 可以使用你为自己撰写的同一批笔记。笔记之间可以相互链接，一篇笔记也可以归属多个主题，因此你可以沿着想法的关联脉络不断探索。
可阅读的记忆。 Agent 保存的决策和经验教训都是普通笔记，你可以浏览、修改或删除。
笔记始终由你掌控。 所有内容都是 Markdown 文件，保存在你设备上的一个文件夹中。你可以备份、同步，也可以将其纳入 git。保存笔记不需要 IWE 云账户；连接 AI Agent 则取决于该 Agent 自身的设置和账户要求。

查看 iwe.md 上的实际效果 →

Mac 版 iWe

如果你想为笔记提供专属空间，可以使用原生 Mac 应用。打开一个笔记文件夹，即可获得一个快速、适合键盘操作的空间来撰写和浏览。你也可以连接现有的 Claude/Codex Agent，与它协同工作。

适配你的 Claude/Codex Agent。 连接你已在使用的 Agent，询问有关笔记的问题，让它起草或重新整理笔记。查看它工作时对文档所做的修改。
自在尝试。 每次 Agent 运行都算作一步撤销操作——尝试一个想法，如果不喜欢，随时撤销。
跟随你的想法。 在相关笔记间跳转，只需敲几下键即可搜索，还能直接在文档中查看 Mermaid 图表。你的编辑器和其他工具可以继续处理同一批文件。

在 iwe.md 上了解 Mac 版 iWe →

打开笔记文件夹，然后从记录手头正在处理的事情开始。连接 Claude/Codex 后，可以试着让它总结这篇笔记，或帮你拓展一个想法。

使用自己的编辑器

继续使用 Neovim、Helix、VS Code 或 Zed 写作。IWE 为笔记添加链接自动补全、反向链接、搜索和安全重命名功能。

按照适用于你编辑器的指南操作，打开笔记文件夹，然后试着用自动补全链接两篇笔记。无需连接 AI Agent，也可以用 IWE 写作。

命令行工具

更喜欢使用终端？使用 IWE 搜索、创建和重新整理笔记，也可以将它融入脚本中。CLI 没有内置 AI：这些命令可以独立运行。你现有的 Claude/Codex Agent 也可以使用 IWE 的工具。

使用 Homebrew 安装，或从安装指南中选择其他方式：

brew install iwe-org/iwe/iwe

然后在笔记文件夹中运行以下命令：

iwe init
iwe find
iwe find --lexical "project decisions"

iwe find 会列出你的笔记；--lexical 会搜索笔记内容。在 CLI 参考和工作流示例中了解更多。

Claude/Codex

你可以完全通过 Agent 使用 IWE。让 Claude/Codex 保存决策、查找过去的工作，并整理已学到的内容。Agent 会通过 IWE 使用你的笔记，你也可以随时自行打开这些文件。

IWE 不绑定某一种 AI。同一份笔记可用于 Claude Code、Claude Desktop、Codex、Gemini、Cursor，以及任何支持 Model Context Protocol 的工具。

为 Claude/Codex 提供记忆——对于 Claude Code，安装插件，然后在希望记录的任意项目中运行 /iwe:init。对于 Codex，请按照下方的 Agent 连接步骤操作。

/plugin marketplace add iwe-org/skills
/plugin install iwe@iwe-org
/iwe:init

然后，让它根据你当前的工作保存一项决策，并在项目中打开它创建的笔记。

连接其他 Agent——安装 Homebrew 后，安装 IWE：

brew install iwe-org/iwe/iwe

在你的笔记文件夹中运行 iwe init，然后按照**Agent 连接指南**，将 iwec MCP 服务添加为 MCP 服务，并将该文件夹设为其工作目录。其他安装方式请参阅安装指南。

连接后，询问你的 Agent：“浏览我的 IWE 笔记并总结其中的内容。”

或者，让 Agent 自行完成设置——将以下内容粘贴到任何能够运行命令的 Agent 中：

Set up IWE for my notes: install it (brew install iwe-org/iwe/iwe,
npm install -g @iwe-org/iwe, or cargo install iwe iwes iwec), run `iwe init`
in my notes directory, then add the `iwec` MCP server with its working
directory set to that folder.
Docs: https://iwe.md/docs/agentic/