Recallbase / Codex CLI + Recallbase

Give Codex CLI a persistent memory

Codex CLI is strong at code – but forgets between sittings. With Recallbase over MCP, Codex remembers project history, decisions and confirmed knowledge.

Why Codex CLI needs a memory

Codex CLI starts each session with no prior knowledge of your project. Recallbase gives Codex access to a persistent memory over MCP – so the agent knows history and earlier decisions instead of starting from zero.

Set up Recallbase in Codex CLI

Prerequisite: a Recallbase account (create one free) and the installed client. Add the MCP server to ~/.codex/config.toml:

[mcp_servers.recallbase]
command = "node"
args = ["/PATH/TO/.claude/brain-helper/dist/index.js", "mcp"]

After restarting Codex CLI, the MCP server recallbase is available.

The four memory tools

Over MCP, Recallbase gives your agent four tools:

• memory_context – loads the project memory into context
• memory_search – full-text and meaning search over past sessions
• memory_save_session – saves a structured summary
• memory_add_knowledge – writes durable knowledge into the graph

To have your agent use them automatically, add to its instruction file (e.g. AGENTS.md / GEMINI.md): "Call memory_context at the start of each session and apply the context. Save via memory_save_session at the end."

Tip for Codex CLI

Add a line to your AGENTS.md telling Codex to call memory_context at session start – then the memory loads automatically.

Read more: Gemini CLI Cursor Claude Code