在 Kiro IDE 中配置 Gentle-AI + Engram：让你的 AI 编码助手拥有持久记忆与专业工作流

前言

作为 Kiro IDE 用户，我一直希望 AI 助手能在多个会话中记住项目上下文、架构决策和重要知识。

Gentleman-Programming 生态中的 gentle-ai + Engram 组合很好地解决了这个问题。

本文将详细介绍 gentle-ai 与 Engram 的关系，以及如何在 Kiro IDE 中通过 gentle-ai 一键完成集成配置。

AI 编码助手的"失忆症"

当你与 AI 编码助手进行一个复杂的重构任务时，流程通常是这样的：

• 第一个 session：讨论架构、设计决策、技术选型
• 第二个 session：AI 已经忘记了之前的讨论，你需要重新解释
• 第三个 session：上下文窗口接近耗尽，AI 开始" hallucination"（虚构）

这是一个系统性的问题，而不是 AI 模型的 bug。即使是最强大的模型，也有上下文长度限制。

上下文窗口耗尽后，AI 就会"忘记"之前讨论的内容、做出的决策、以及积累的技术上下文。

1. Engram 是什么？

Engram 是一个专为 AI coding agents 设计的持久化内存系统（Persistent Memory System）。它解决了当前大多数 AI 助手最大的痛点：每次新会话都像失忆一样，从零开始。

核心特点：

• 使用本地 SQLite + FTS5 全文搜索，存储速度快、索引强大
• 通过 MCP（Model Context Protocol） 协议与各种 AI agent 无缝通信
• 支持 mem_save、mem_search、mem_context、mem_timeline 等 17 个 MCP 工具
• 提供 CLI、TUI（终端图形界面）、HTTP API 和 MCP Server
• 内存支持结构化保存（标题、类型、What/Why/Where/Learned），并可按项目、时间线管理
• 支持 Git-based 同步和可选的云复制（本地数据库始终为主）

简单来说，Engram 就是给你的 AI 装上了一个长期记忆大脑。它能记住你项目中的重要决策、已修复的 bug、架构选择、项目规范等，下次打开项目时 AI 可以直接调用这些记忆，大幅提升连续性和一致性。

仓库地址：https://github.com/Gentleman-Programming/engram

2. gentle-ai 是什么？它和 Engram 是什么关系？

gentle-ai 不是另一个 AI agent，而是 Gentleman AI 生态的统一安装器和配置器（Ecosystem Configurator）。

它的核心作用是：把 Engram、SDD（Spec-Driven Development）、Skills、Persona 等组件，自动、正确地集成到你正在使用的任何 AI coding agent 或 IDE 中。

gentle-ai 与 Engram 的关系：

• Engram 是核心的“硬件”——负责实际的记忆存储和 MCP 服务。
• gentle-ai 是“安装系统 + 驱动程序”——负责检测你的环境（例如 Kiro）、自动写入正确的配置文件、注入原生 subagents、steering 文件，并确保 Engram 能正常在该环境中运行。
• gentle-ai 支持包括 Kiro IDE 在内的多个工具，并提供 full-gentleman、minimal 等预设，一键帮你组装完整的 Gentleman Stack。

想用 Engram 的强大记忆功能，最推荐的方式就是通过 gentle-ai 来安装和配置，尤其是对 Kiro 这种有特殊配置路径（split-root layout）的 IDE 来说，手动配置容易出错，而 gentle-ai 已完美处理了兼容性。

仓库地址：https://github.com/Gentleman-Programming/gentle-ai

3. 在 Kiro IDE 中配置 gentle-ai + Engram 的完整步骤

前提：

• 已安装 Kiro IDE（gentle-ai 会检测 ~/.kiro 目录）
• macOS / Linux（本文以 macOS 为例，Windows 类似）

步骤 1：安装 gentle-ai（推荐方式）

# 使用 Homebrew（推荐）
brew tap Gentleman-Programming/homebrew-tap
brew install gentle-ai

# 或者使用一键安装脚本
curl -fsSL https://raw.githubusercontent.com/Gentleman-Programming/gentle-ai/main/scripts/install.sh | bash

步骤 2：同时安装 Engram（gentle-ai 会自动处理，但也可单独安装）

brew install gentleman-programming/tap/engram

步骤 3：运行 gentle-ai 配置 Kiro + Engram

运行以下命令进入交互式 TUI（推荐）

gentle-ai

进入终端图形界面后，按以下步骤操作：

• 选择目标 Agent → Kiro IDE（gentle-ai 会检测 ~/.kiro 目录）
• Preset：推荐选择 full-gentleman（包含 Engram + SDD + Skills + Persona）
• Components：勾选需要安装的组件，确保 engram 被选中
• 确认后让 gentle-ai 执行安装流程

gentle-ai 会自动完成以下工作：

• 在 ~/.kiro/settings/mcp.json 中注册 Engram MCP server
• 在 ~/.kiro/agents/ 目录下写入 Kiro 原生 subagents（sdd-xxx 系列，共 10 个阶段代理）
• 注入 steering 文件和 skills
• 处理 Kiro 特有的 split-root 配置路径

步骤 4： 让 Kiro 自动管理 Engram（推荐方式）

配置完成后，推荐不要把 engram mcp 做成常驻后台服务，而是让 Kiro 按需自动启动。

编辑全局 MCP 配置文件：

vim ~/.kiro/settings/mcp.json

推荐的 mcp.json 配置：

{
  "mcpServers": {
    "engram": {
      "enabled": true,
      "name": "Engram Memory",
      "command": "/opt/homebrew/bin/engram",
      "args": ["mcp"],
      "transportType": "stdio",
      "timeout": 30000,
      "autoApprove": [
        "mem_save",
        "mem_update",
        "mem_search",
        "mem_context",
        "mem_timeline",
        "mem_get_observation",
        "mem_session_start",
        "mem_session_summary",
        "mem_current_project"
      ]
    }
  }
}

关键点：

• 使用 transportType: "stdio" 让 Kiro 自动启动和关闭 Engram 进程
• 添加常用工具到 autoApprove，减少手动确认
• 配置完成后重启 Kiro，然后在左侧 MCP Servers 面板中检查 Engram 是否出现并尝试连接

步骤 5：验证配置

• 重启 Kiro 后，在 MCP Servers 面板查看 Engram 状态
• 使用 engram tui 查看内存浏览器
• 在聊天中测试记忆功能，例如：
  • “使用 Engram 保存我们对认证流程的决策”
  • “搜索项目中之前提到的数据库选型记忆”

项目级初始化（强烈建议每个新项目都做一次）

打开 Kiro，进入你的项目，运行以下命令（在 agent 聊天中输入）：

• /sdd-init — 自动检测技术栈、测试框架等，启用 Strict TDD（如果支持）
• skill-registry — 扫描 skills 和项目约定，生成 registry

这些不是必须的，SDD orchestrator 会自动检测并运行。但手动跑一次能确保上下文最新，尤其项目加了新依赖/测试框架时。

4. 配置完成后你将获得什么？

• 持久记忆：AI 能记住项目历史决策、bug 修复记录、架构选择等
• SDD 工作流：Spec-Driven Development + 多阶段原生 subagents
• 丰富 Skills：自动加载编码最佳实践、测试模式等
• 教学型 Persona：AI 不仅帮你写代码，还会解释和教学
• 跨会话一致性：新会话打开项目时，AI 直接“知道”之前做了什么

5. 常见问题与建议

• 如果 gentle-ai 没有自动检测到 Kiro，确保先启动一次 Kiro 创建 ~/.kiro 目录。
• 想只安装 Engram 而非完整栈？可以使用 gentle-ai 的自定义组件选择。
• gentle-ai 的 TUI 配置比直接使用命令行参数更稳定，尤其适合 Kiro IDE。
• 升级时建议运行 gentle-ai 的 sync 或 upgrade 流程。
• 如果修改 ~/.kiro/settings/mcp.json 后未立即生效，可尝试：
  • 在 Kiro 中使用 /mcp reload 或 /mcp list 命令
  • 完全退出 Kiro（Quit）后再重新打开
  • 检查项目目录下是否已有 .kiro/settings/mcp.json（会覆盖全局配置）
• 目前 gentle-ai 对 Kiro 的支持仍在快速发展，建议定期运行 gentle-ai 检查更新。