运行一次 setup 并重启你的 AI 工具。之后 Engram 会以 MCP 工具和启动指南出现；需要时再查看下面的专用工具。
你只运行一个终端命令：npx engram-tools@0.3.6 --setup <api-key>。它会尽可能为 Claude Code、Cursor、Gemini、Antigravity、Codex、OpenCode 和 VS Code/Copilot 写入 MCP 配置。
$ npx -y engram-tools@0.3.6 --setup <api-key>
你不会在 shell 中运行 engram_start。setup 后，客户端会把 Engram 工具和启动指南展示给 agent。你正常描述任务即可；如果客户端忽略指南，再粘贴一次简短上下文提示。
你：在这个 repo/task 上工作。规划前先使用 Engram 上下文。
重启后，AI 客户端会加载 Engram MCP server。agent 会看到 engram_start、engram_store、engram_recall 等工具，以及 AGENTS.md 指南和 Claude slash helper。
Agent 会看到: engram_start, engram_store, engram_recall...
setup 命令会自动处理。下面展示不使用默认 JSON 格式的客户端实际需要的配置形状。
Google 当前的 Gemini 流程可能会把用户引导到 Antigravity。Engram 会同时写入共享 Gemini 配置和 Antigravity 专用配置文件。
// ~/.gemini/config/mcp_config.json// ~/.gemini/antigravity/mcp_config.json{"mcpServers": {"engram": {"command": "npx","args": ["-y", "engram-tools", "mcp"]}}}
OpenCode 使用命令数组，而不是标准 mcpServers 结构。setup 会自动写入这种格式。
// ~/.config/opencode/opencode.json{"mcp": {"engram": {"type": "local","command": ["npx", "-y", "engram-tools", "mcp"],"enabled": true}}}
Codex 使用 TOML。Engram 只替换 engram 表，并保留其他 Codex 配置。
# ~/.codex/config.toml[mcp_servers.engram]type = "stdio"command = "npx"args = ["-y", "engram-tools", "mcp"]
正常编码流程中最常用的四个工具。
保留可用，但只有触发条件真实时才使用。
engram_start当 agent 需要时使用 启动会话.
agent_toolCodex、Claude Code、Cursor 等客户端名称。
project产品或客户名称。
repo用于筛选私有记忆的 repo 或项目名。
roleagent 应该扮演的角色。
market领域或市场背景。
taskagent 当前要做的任务。
stack相关技术栈。
context问题、任务或当前上下文。
include_skills默认 true，包含匹配的技能指南。
limit最多返回的结果数量。
支持和反馈
如果 setup 让人困惑、工具行为异常或价格限制看起来不对，请在这里告诉我们。消息会直接到我们这里。