接入指南 · connect guide

把 iHow Memory 接进你的 AI

完全免费开源 · Apache-2.0 本地优先 · 数据不出本机

你已经在用 AI 了——最省事的方式是让它自己帮你接;想自己来,看下面的「手动接入」。

全自动接入推荐

让你的 AI 帮你接(含环境自检)

不用自己折腾配置文件,也不用管自己是哪个工具。把下面这段话复制,发给你正在用、能在终端跑命令的 AI 编码 agent——它会先帮你检查 Node 环境(不够会指你去装),再跑一条 setup 自动检测并配好你机器上装着的 AI 工具。(纯聊天界面、跑不了命令的,走下面的「手动接入」。)

帮我接入 iHow Memory——一个本地、免费、开源的 AI 记忆层,让你跨会话、跨工具记住这个项目。请按步骤来:① 先在终端跑 node -v 检查 Node 版本,需 ≥ v22.12;若低于此或没装,告诉我去 https://nodejs.org/en/download 装 LTS(macOS/Linux 也可用 nvm:nvm install 22 && nvm use 22;Windows 推荐在 WSL 里装,或直接装官网 LTS),装好再继续。② 然后在终端运行 npx ihow-memory@next setup(它会自动检测我机器上装了哪些 AI 工具,逐个配好 MCP + 续接技能/钩子,先备份、不覆盖我现有配置)。③ 再跑 npx ihow-memory@next verify 把回执发我看,并提示我是否需要重启对应工具。全程本地,数据不出我的机器;需要我授权的操作先问我。如果你没法在终端跑命令,告诉我去 github.com/iHow1/ihow-memory-core 看手动接入。

手动接入

想自己来,或你的 AI 跑不了终端命令?先自检环境,再按你正在用的工具接。

① 先自检环境 Node ≥ v22.12 · macOS / Linux / Windows(WSL 推荐)

node -v

看到 v22.12.0 或更高就行。低于此或还没装 → 下载 Node.js(选 LTS);用 nvm / fnm 的:nvm install 22 && nvm use 22,之后从这个 Node 版本跑 connect。Windows 建议在 WSL 里装 Node 后接入(已验证路径);原生 Windows 为实验性,Claude Code / Cursor / Claude Desktop / WorkBuddy / OpenCode / OpenClaw 可直接写配置,Codex / Hermes 需用 ihow-memory@next init --runtime <name> 拿手动片段贴入。

② 选你正在用的工具

每个工具一行命令(已含 --easy,会自动配好、先备份、不覆盖你现有配置)。没在下面?任何兼容 MCP 的工具都能接,手动配置见 GitHub 接入说明。

Codex 一键 · 免费 ~/.codex/config.toml

官方 CLI 接入(codex mcp add),已存在则自动更新、保留其它配置。需本机已装 Codex CLI;没有的话用 ihow-memory init --runtime codex 拿手动配置片段。

npx ihow-memory@next connect --runtime codex --easy

完成后重启 Codex 加载 memory 工具。

Claude Code 一键 · 免费完整续接 · 最成熟 ~/.claude.json

官方 CLI 接入,一行搞定 —— 自动备份、不覆盖你现有的 MCP server。当前唯一每天 dogfood、完整跨会话续接的一档。

npx ihow-memory@next connect --runtime claude-code --easy

完成后重启 Claude Code,工具里即出现 memory.search / read / write 等。

WorkBuddy 一键 · 免费 ~/.workbuddy/mcp.json

WorkBuddy 兼容标准 stdio MCP。一键写入 ~/.workbuddy/mcp.json,先备份、不动其它 server。

npx ihow-memory@next connect --runtime workbuddy --easy

已验证可接;精确文件名 / 字段以本地 WorkBuddy 实际为准。完成后重启 WorkBuddy。

Cursor 一键 · 免费仅接收 · 暂不能续接 ~/.cursor/mcp.json

写入 Cursor 的 MCP 配置 —— 先备份再合并,不动其它 server。当前为只接收档:能调用 memory 工具,但还不能自动续接(resume)。

npx ihow-memory@next connect --runtime cursor --easy

完成后重启 Cursor。

Claude Desktop 一键 · 免费仅接收 · 暂不能续接 ~/Library/Application Support/Claude/ · Win:%APPDATA%\Claude

Anthropic 桌面应用,标准 mcpServers JSON。一键写入 claude_desktop_config.json(macOS / Windows / Linux 路径自动识别),先备份、不动其它 server。只接收档:能调用 memory 工具,暂不能自动续接。

npx ihow-memory@next connect --runtime claude-desktop --easy

完成后重启 Claude Desktop。

OpenCode 一键 · 免费 ~/.config/opencode

OpenCode 兼容 MCP。一键写入 ~/.config/opencode/opencode.json,先备份、不覆盖其它 server。

npx ihow-memory@next connect --runtime opencode --easy

完成后重启 OpenCode。

Hermes 一键 · 冒烟级 hermes mcp add · ~/.hermes/config.yaml

通过官方 hermes mcp add 接入——connect + 续接 reader 均可用(单机真机冒烟级)。需本机已装 Hermes CLI;没有的话用 ihow-memory init --runtime hermes 拿手动配置片段。

npx ihow-memory@next connect --runtime hermes --easy

完成后重启 Hermes 加载 memory 工具。

OpenClaw 一键 · 冒烟级 ~/.openclaw/openclaw.json

一键写入 OpenClaw 的 MCP 配置(嵌套 mcp.servers)——先备份再合并,不动其它 server;connect + memory.continue 续接均可用(单机真机冒烟级)。

npx ihow-memory@next connect --runtime openclaw --easy

完成后重启 OpenClaw。