OpenAI Codex CLI Integration Guide

{
  "mcpServers": {
    "engram": {
      "type": "http",
      "url": "https://mcp.getengram.app/mcp",
      "headers": {
        "Authorization": "Bearer engram_sk_live_your_key_here"
      }
    }
  }
}

## Engram Memory
 
You have access to Engram as an MCP server. Use it to maintain persistent memory across sessions.
 
### On session start
 
Search Engram for context relevant to the current task:
 
    search
      query: "<summary of what the user is asking about>"
      limit: 5
 
Include any relevant results in your working context — they contain prior conversations about this project, decisions made, bugs investigated, and user preferences.
 
### During the session
 
When significant work is done or important context is established, store it:
 
    create_conversation
      title: "<concise description of what was discussed>"
      agent_id: "codex"
      tags: ["<project-name>", "<topic>"]
      metadata: { "project": "<project-name>" }
 
    append_messages
      conversation_id: "<the conversation ID>"
      messages:
        - role: "user"
          content: "<what the user asked>"
        - role: "assistant"
          content: "<what you did and why>"
 
### What to store
 
- Decisions and their reasoning ("we chose X because Y")
- Bug investigations and resolutions
- User preferences and workflow patterns
- Architecture discussions
- Anything you'd want to remember next session
 
### What NOT to store
 
- Routine file reads or searches
- Trivial exchanges ("hello", "thanks")
- Information already in the codebase or git history

You: Refactor the payment module to use Stripe's new v2 API.
     Make sure we keep the webhook signature verification.

Codex: [searches Engram — no prior context]
Codex: I'll refactor the payment module from Stripe v1 to v2...
Codex: [stores in Engram:
  title: "Stripe v1 → v2 migration for payment module"
  tags: ["payments", "migration", "stripe"]
  messages: migration approach, webhook verification requirement]

You: Add subscription management to the payment module.

Codex: [searches Engram → finds Stripe migration context]
Codex: I see we recently migrated to Stripe's v2 API. I'll implement
       subscription management using the v2 Subscriptions API,
       consistent with the existing payment module patterns...