接入指南 · connect guide

把 iHow Memory 接进你的 AI

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

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

全自动接入推荐

让你的 AI 帮你安装或更新(含环境自检与恢复)

不用自己折腾配置文件,也不用先判断是新装还是更新。把下面这段话复制,发给你正在用、能在终端跑命令的 AI 编码 agent——它会先确认项目目录与 Node 环境,再用 doctor 判断应该执行 setup、upgrade 还是 rescue,最后给出验证回执和重启提示。(纯聊天界面、跑不了命令的,走下面的「手动接入」。)

帮我安装或更新 iHow Memory——一个本地、免费、开源的 AI 记忆层，让你跨会话、跨工具记住这个项目。请按步骤执行：① 开始前确认终端位于我希望记忆的项目根目录；若不确定，先问我。然后运行 node -v，要求 Node ≥ v22.12；若版本过低或未安装，告诉我如何从 https://nodejs.org/en/download 安装 Node LTS（macOS/Linux 也可用 nvm：nvm install 22 && nvm use 22；Windows 优先推荐 WSL），Node 就绪后继续。② 运行 npx ihow-memory@next doctor --json 检查当前状态，不要手工改写 Hook 或 MCP 配置。首次安装时，doctor 返回“未接入”、缺少 runtime 或非零退出码属于诊断结果，不要因此停止。若这个项目从未接入，运行 npx ihow-memory@next setup；若已经接入，或我明确要求更新/修复，运行 npx ihow-memory@next upgrade --json。若冻结 runtime/旧升级器损坏导致 upgrade 无法启动，改用 npx ihow-memory@next rescue --json。只有某一个宿主注册仍指向已删除或移动的 workspace 时，才添加 --runtime <name>，不要批量乱改所有应用。③ 再运行 npx ihow-memory@next doctor 和 npx ihow-memory@next verify，把回执与 restartRequired 结果发给我，并明确告诉我需要重启哪些对应工具。全程本地，数据不出我的机器；这段提示词已经授权你执行只读检查和适用的 setup/upgrade/rescue 命令，任何无关或破坏性操作仍需先问我。若你无法运行终端命令，请使用 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。

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。