连接 iCode

先使用统一安装指南，让你的 agent 读取它并为 iCode 安装 Nowledge Mem。

手动安装需要 iCode（Python 包名为 icode-tui）、Git、uv 和 nmem CLI。先把 nmem 配置到你要使用的 workspace，并运行 nmem doctor。

在 iCode 中打开 /agents，选择 Code，保存一次 profile。安装器需要已保存的 profile，不会用不完整配置替换内置 agent。
macOS 或 Linux 运行：

bash -lc 'tmp="$(mktemp -d)" && git clone --depth 1 https://github.com/nowledge-co/community.git "$tmp/community" && uv run --no-project --with pyyaml python "$tmp/community/nowledge-mem-icode-plugin/scripts/install.py"'

Windows PowerShell 用户请克隆到新目录：

$checkout = Join-Path ([System.IO.Path]::GetTempPath()) ("nowledge-community-" + [guid]::NewGuid().ToString("N"))
git clone --depth 1 https://github.com/nowledge-co/community.git $checkout
if ($LASTEXITCODE -ne 0) { throw "Community clone failed; installer not run." }
uv run --no-project --with pyyaml python (Join-Path $checkout "nowledge-mem-icode-plugin/scripts/install.py")
if ($LASTEXITCODE -ne 0) { throw "iCode installer failed; setup is incomplete." }

重启 iCode，在 /agents 中打开 Code 的 MCP 页签，测试 nowledge-mem。新建会话并让它搜索一条已知记忆。Context Bundle 成功加载时，会出现 [Nowledge Mem] system reminder；只有提醒文字不代表连接成功。

其他 profile 请先保存，再加 --agent <Name>。uv 会提供 PyYAML，无需全局安装。 --dry-run 只预览隐藏密钥的配置，不写入文件。

选择 App 或 Cloud workspace

安装器使用 CLI 的 apiUrl 和 apiKey。安装前，把 nmem 配置到所选 Cloud workspace，或 App 的 Nowledge Link / Access Anywhere 地址。远程连接必须使用 HTTPS 和该地址对应的 API key；覆盖 URL 时不会悄悄复用另一个地址的密钥。

密钥会写入 agent profile 和安装记录，不会打印。请保管好这些文件及其 *.nmem-bak 备份。更换地址或密钥轮换后，即使 URL 未变，也要重新运行安装器，再重启 iCode 并测试 MCP。profile 保存的是密钥副本，不会自动读取 CLI 中的新密钥。 hook 继承 CLI 配置，不读取 MCP server 配置块。

支持的行为

在 ~/.chrys/agents/Code.yaml 中添加 HTTP MCP server，使用 exact-v1 与精简的 external-agent schema。搜索、新增、更新和 Context Bundle 工具保持加载，其他工具由 iCode 按需加载。
在 ~/.chrys/hooks/ 添加 user_prompt_submit hook，先尝试 Context Bundle，再回退到 Working Memory，总等待最多八秒。后端错误不会阻断提交。
在 ~/.agents/skills 安装六个技能，默认保留已有技能。后续提示会提醒 agent 检索相关历史、保存长期有用的结果，不会自动执行搜索。

Windows 的 iCode 配置位于 %APPDATA%/chrys。用 save-handoff 保存可续接的摘要，用 memory_add 保存长期事实。目前没有 iCode 会话解析器，也不新增斜杠命令。

更新、移除和排查

重复安装命令即可更新。修改过的 MCP/hook 配置会让更新停止；明确使用 --force 才会替换，并保留备份。在 community 仓库根目录移除：

uv run --no-project --with pyyaml python nowledge-mem-icode-plugin/scripts/install.py --remove

移除只删除未修改的受管文件，恢复此前的配置和文件，保留用户修改或其他 connector 提供的技能。备份不会删除。操作后重启 iCode；更换 profile 或技能目录前请先移除。

上下文没有出现时，在 iCode 相同环境运行 nmem status 和 nmem context --source-app icode。CLI 首次下载若超过 hook 预算，请单独预热。 NMEM_ICODE_TIMEOUT_SECONDS 最多八秒，不适合等待长时间下载。 NMEM_ICODE_CONTEXT=off 关闭整个 hook； NMEM_ICODE_RECALL=every|first|off 控制检索提醒。

自定义配置路径与开发测试见 connector README。

iCode 可以通过 MCP 搜索和写入 Mem。提示 hook 负责加载当前上下文，共享技能引导检索、提炼和保存交接摘要。此连接不自动采集完整会话。

连接 iCode

先使用统一安装指南，让你的 agent 读取它并为 iCode 安装 Nowledge Mem。

手动安装需要 iCode（Python 包名为 icode-tui）、Git、uv 和 nmem CLI。先把 nmem 配置到你要使用的 workspace，并运行 nmem doctor。

在 iCode 中打开 /agents，选择 Code，保存一次 profile。安装器需要已保存的 profile，不会用不完整配置替换内置 agent。
macOS 或 Linux 运行：

bash -lc 'tmp="$(mktemp -d)" && git clone --depth 1 https://github.com/nowledge-co/community.git "$tmp/community" && uv run --no-project --with pyyaml python "$tmp/community/nowledge-mem-icode-plugin/scripts/install.py"'

Windows PowerShell 用户请克隆到新目录：

$checkout = Join-Path ([System.IO.Path]::GetTempPath()) ("nowledge-community-" + [guid]::NewGuid().ToString("N"))
git clone --depth 1 https://github.com/nowledge-co/community.git $checkout
if ($LASTEXITCODE -ne 0) { throw "Community clone failed; installer not run." }
uv run --no-project --with pyyaml python (Join-Path $checkout "nowledge-mem-icode-plugin/scripts/install.py")
if ($LASTEXITCODE -ne 0) { throw "iCode installer failed; setup is incomplete." }

重启 iCode，在 /agents 中打开 Code 的 MCP 页签，测试 nowledge-mem。新建会话并让它搜索一条已知记忆。Context Bundle 成功加载时，会出现 [Nowledge Mem] system reminder；只有提醒文字不代表连接成功。

其他 profile 请先保存，再加 --agent <Name>。uv 会提供 PyYAML，无需全局安装。 --dry-run 只预览隐藏密钥的配置，不写入文件。

选择 App 或 Cloud workspace

支持的行为

在 ~/.chrys/agents/Code.yaml 中添加 HTTP MCP server，使用 exact-v1 与精简的 external-agent schema。搜索、新增、更新和 Context Bundle 工具保持加载，其他工具由 iCode 按需加载。
在 ~/.chrys/hooks/ 添加 user_prompt_submit hook，先尝试 Context Bundle，再回退到 Working Memory，总等待最多八秒。后端错误不会阻断提交。
在 ~/.agents/skills 安装六个技能，默认保留已有技能。后续提示会提醒 agent 检索相关历史、保存长期有用的结果，不会自动执行搜索。

Windows 的 iCode 配置位于 %APPDATA%/chrys。用 save-handoff 保存可续接的摘要，用 memory_add 保存长期事实。目前没有 iCode 会话解析器，也不新增斜杠命令。

更新、移除和排查

重复安装命令即可更新。修改过的 MCP/hook 配置会让更新停止；明确使用 --force 才会替换，并保留备份。在 community 仓库根目录移除：

uv run --no-project --with pyyaml python nowledge-mem-icode-plugin/scripts/install.py --remove

自定义配置路径与开发测试见 connector README。

iCode

连接 iCode

选择 App 或 Cloud workspace

支持的行为

更新、移除和排查

On this page

iCode

连接 iCode

选择 App 或 Cloud workspace

支持的行为

更新、移除和排查

On this page