Integrations
Codex
AI Tool

Codex

Add long-term memory to Codex-style CLI coding assistants with Memaster scripts, Skills, or MCP where available.

CLI workflowSkillsREST

Codex 类命令行编码助手适合通过脚本和工作流接入 Memaster：在任务开始前检索长期记忆，在完成后写入可复用结论。如果客户端支持 Remote HTTP MCP，可直接连接 Memaster 托管 endpoint；没有原生 MCP 时，也可以通过 memaster_memory.py 实现完整记忆闭环。

CLI friendly用一条 Python 命令完成检索、写入、更新和删除。
No lock-in适配任何能运行 shell 命令的 Codex 类工具。
Scoped recall通过 project、area、scope 和 tags 控制召回上下文。

推荐接入方式

  • 工作流脚本 —— 在 Codex 任务开始和结束时运行 memaster_memory.py。
  • Skills / Rules —— 如果客户端支持自定义说明，把 Skills 接入 中的模板加入规则。
  • MCP —— 如果客户端支持 Remote HTTP MCP，直接配置 https://api.memaster.cn/mcp 和 X-API-Key；只支持 stdio 或无 MCP 时，继续使用本地脚本或本地 bridge。
⚠️

只把稳定、可复用、已验证的信息写入 Memaster。不要写入命令输出里的密钥、Token、路径凭据或 .env 真实值。

MCP 可选配置

如果 Codex 类客户端支持 Remote HTTP MCP，可使用统一的托管 endpoint：

mcp.json
{
  "mcpServers": {
    "memaster": {
      "type": "http",
      "url": "https://api.memaster.cn/mcp",
      "headers": {
        "X-API-Key": "msk_xxx"
      }
    }
  }
}

只支持 stdio MCP 的客户端需要本地 bridge 转发到 https://api.memaster.cn/mcp；没有 MCP 能力时使用下面的本地脚本方式。

安装

复制 Skill

cp -R skills/memaster-memory .codex/skills/memaster-memory

如果你的 Codex 客户端没有固定 skills 目录，也可以放在仓库内的任意工具目录，例如 tools/memaster-memory。

配置环境变量

cp .codex/skills/memaster-memory/.env.example .codex/skills/memaster-memory/.env.local
MEMASTER_API_KEY=msk_xxx
MEMASTER_USER_ID=alice
MEMASTER_AGENT_ID=codex
MEMASTER_SOURCE=codex
MEMASTER_PROJECT=my-repo
MEMASTER_AREA=cli

验证

python3 .codex/skills/memaster-memory/scripts/memaster_memory.py doctor

推荐 Prompt / Workflow

开始任务前，先运行 Memaster search，检索项目规范、用户偏好和历史调试记录。修改核心逻辑前再次检索相关实现模式。任务结束后，只保存已验证且不包含敏感信息的结论。

CLI 示例

检索

python3 .codex/skills/memaster-memory/scripts/memaster_memory.py search \
  --query "当前任务相关的项目约定和历史实现是什么？" \
  --project "my-repo" \
  --area "cli" \
  --top-k 5

写入

python3 .codex/skills/memaster-memory/scripts/memaster_memory.py add \
  --title "CLI 任务完成验证" \
  --content "修改 CLI 参数解析后需要运行单元测试和一次 doctor 命令验证配置。" \
  --memory-type implementation \
  --project "my-repo" \
  --area "cli" \
  --scope "cli-workflow" \
  --tags "CLI,测试,验证"

更新

python3 .codex/skills/memaster-memory/scripts/memaster_memory.py update \
  --memory-id "memory-id" \
  --content "新的稳定结论" \
  --project "my-repo" \
  --area "cli"

故障排查

现象检查项
命令找不到脚本使用绝对路径或确认 Skill 复制位置
401MEMASTER_API_KEY 是否有效
检索噪声过多使用 --project、--area、--memory-type
不知道该写什么只写偏好、规范、决策、修复和验证结论

下一步

Skills 接入MCP 接入GitHub Copilot 接入
DevinCodeBuddy