iwe

环境要求

• macOS/Linux/Windows 桌面环境（npm 方式三平台通用）
• macOS/Linux 可用 Homebrew，或用 Cargo/conda 等其他方式
• 一个存放 Markdown 笔记的本地目录（如 ~/notes）
• 可选：Node.js（用于 npm 安装或 npx 运行 MCP 服务器）

安装与启动步骤

1. 1安装 CLI 与 LSP

   任选一种方式安装：Homebrew、npm、Cargo 或 conda。此处以 Homebrew（macOS/Linux）为例。

   brew install iwe-org/iwe/iwe

   复制

2. 2初始化笔记工作区

   进入你存放 Markdown 笔记的目录，执行 iwe init 把该目录初始化为 IWE 工作区。

   cd ~/notes
   iwe init

   复制

3. 3为编辑器接入 LSP

   按所用编辑器（VS Code、Neovim、Helix、Zed）的官方文档完成 LSP 配置，即可使用搜索、重构、重命名和自动补全。

4. 4用 iwec 连接 AI 代理

   在 MCP 客户端配置中加入 iwe 服务，command 用 iwec；iwec 服务的是它运行时所在的目录，所以 cwd 必须指向笔记目录。

   {
     "mcpServers": {
       "iwe": {
         "command": "iwec",
         "cwd": "~/notes"
       }
     }
   }

   复制

5. 5或用 npx 免安装

   不想单独安装 MCP 服务器时，用 npx 按需拉取 @iwe-org/mcp，cwd 同样指向笔记目录。

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

   复制

6. 6给 Claude Code 记忆

   在 Claude Code 中先添加插件市场再安装插件，随后在需要被记忆的仓库里运行 /iwe:init。

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

   复制

关键配置

如何确认成功

在编辑器中打开笔记目录，链接能自动解析、搜索/重命名/补全可用，说明 LSP 已接入成功。

常见问题

注意事项

• 笔记保持纯 Markdown，可自由读写并 git push，不存在专有格式。
• IWE 用链接把笔记连成图，同一篇笔记可属于多个主题而无需复制文件。
• 从 Cargo 安装（cargo install iwe iwes iwec）会得到 iwe、iwes、iwec 三个命令。
• MCP 客户端配置细节请参考官方文档 https://iwe.md/docs/agentic/。