codex-mem

语言 / Language: 中文 | English

---

中文

codex-mem 是一个通过 MCP 接入 Codex 的持久记忆服务：自动提取会话上下文、压缩存储，并在新会话开始时注入压缩上下文。

快速接入

1. Clone 项目

git clone https://github.com/rong5690001/codex-mem.git
cd codex-mem

2. 配置 Codex MCP（~/.codex/config.toml）

[mcp_servers.codex_mem]
command = "python3"
args = ["-m", "codex_mem", "mcp"]
enabled = true

[mcp_servers.codex_mem.env]
CODEX_MEM_DB_PATH = "/path/to/.codex-mem/codex-mem.db"
CODEX_MEM_AUTO_SAVE = "1"
CODEX_MEM_AUTO_SAVE_SESSIONS_ROOT = "/path/to/.codex/sessions"
CODEX_MEM_AUTO_SAVE_STATE = "/path/to/.codex-mem/autosave-state.json"
CODEX_MEM_CONTEXT_BUDGET_CHARS = "1600"

3. 重启 Codex App（使 MCP 配置生效）

路径说明

• CODEX_MEM_DB_PATH：SQLite 数据库文件路径
• CODEX_MEM_AUTO_SAVE_SESSIONS_ROOT：Codex 会话日志目录（*.jsonl）
• CODEX_MEM_AUTO_SAVE_STATE：自动保存扫描进度状态文件

常见路径示例：

• macOS
  • /Users/<your-username>/.codex-mem/codex-mem.db
  • /Users/<your-username>/.codex/sessions
  • /Users/<your-username>/.codex-mem/autosave-state.json
• Linux
  • /home/<your-username>/.codex-mem/codex-mem.db
  • /home/<your-username>/.codex/sessions
  • /home/<your-username>/.codex-mem/autosave-state.json
• Windows
  • C:\\Users\\<your-username>\\.codex-mem\\codex-mem.db
  • C:\\Users\\<your-username>\\.codex\\sessions
  • C:\\Users\\<your-username>\\.codex-mem\\autosave-state.json

MCP 配置 JSON（示例）

{
  "mcpServers": {
    "codex-mem": {
      "command": "python3",
      "args": ["-m", "codex_mem", "mcp"],
      "env": {
        "CODEX_MEM_DB_PATH": "/path/to/.codex-mem/codex-mem.db",
        "CODEX_MEM_AUTO_SAVE": "1",
        "CODEX_MEM_AUTO_SAVE_SESSIONS_ROOT": "/path/to/.codex/sessions",
        "CODEX_MEM_AUTO_SAVE_STATE": "/path/to/.codex-mem/autosave-state.json",
        "CODEX_MEM_CONTEXT_BUDGET_CHARS": "1600"
      }
    }
  }
}

行为说明

• MCP 启动后默认开启自动保存（可用 CODEX_MEM_AUTO_SAVE=0 关闭）
• 会自动提取并压缩：用户上下文、助手最终结论、关键工具证据
• 在 MCP initialize 阶段自动返回压缩上下文（instructions）

---

English

codex-mem is an MCP-based persistent memory service for Codex. It automatically extracts and compresses session context, stores it, and injects compressed context at new session start.

Quick Integration

1. Clone the project

git clone https://github.com/rong5690001/codex-mem.git
cd codex-mem

2. Configure Codex MCP in ~/.codex/config.toml

[mcp_servers.codex_mem]
command = "python3"
args = ["-m", "codex_mem", "mcp"]
enabled = true

[mcp_servers.codex_mem.env]
CODEX_MEM_DB_PATH = "/path/to/.codex-mem/codex-mem.db"
CODEX_MEM_AUTO_SAVE = "1"
CODEX_MEM_AUTO_SAVE_SESSIONS_ROOT = "/path/to/.codex/sessions"
CODEX_MEM_AUTO_SAVE_STATE = "/path/to/.codex-mem/autosave-state.json"
CODEX_MEM_CONTEXT_BUDGET_CHARS = "1600"

3. Restart Codex App

Path Guide

• CODEX_MEM_DB_PATH: SQLite DB file path
• CODEX_MEM_AUTO_SAVE_SESSIONS_ROOT: Codex session logs directory (*.jsonl)
• CODEX_MEM_AUTO_SAVE_STATE: autosave progress state file

Common examples:

• macOS
  • /Users/<your-username>/.codex-mem/codex-mem.db
  • /Users/<your-username>/.codex/sessions
  • /Users/<your-username>/.codex-mem/autosave-state.json
• Linux
  • /home/<your-username>/.codex-mem/codex-mem.db
  • /home/<your-username>/.codex/sessions
  • /home/<your-username>/.codex-mem/autosave-state.json
• Windows
  • C:\\Users\\<your-username>\\.codex-mem\\codex-mem.db
  • C:\\Users\\<your-username>\\.codex\\sessions
  • C:\\Users\\<your-username>\\.codex-mem\\autosave-state.json

MCP JSON Config (Example)

{
  "mcpServers": {
    "codex-mem": {
      "command": "python3",
      "args": ["-m", "codex_mem", "mcp"],
      "env": {
        "CODEX_MEM_DB_PATH": "/path/to/.codex-mem/codex-mem.db",
        "CODEX_MEM_AUTO_SAVE": "1",
        "CODEX_MEM_AUTO_SAVE_SESSIONS_ROOT": "/path/to/.codex/sessions",
        "CODEX_MEM_AUTO_SAVE_STATE": "/path/to/.codex-mem/autosave-state.json",
        "CODEX_MEM_CONTEXT_BUDGET_CHARS": "1600"
      }
    }
  }
}

Runtime Behavior

• Auto-save is enabled by default when MCP starts (CODEX_MEM_AUTO_SAVE=0 to disable)
• Captures and compresses: user context, final assistant summaries, key tool evidence
• Returns compressed memory context in MCP initialize via instructions