Codex runs tasks in sandboxed environments with session-scoped context. Neotoma adds persistent memory that survives across sessions, tasks, and tools. The CLI provides a fallback when MCP is not available.
Looking for ChatGPT (conversations, custom GPTs, or developer-mode MCP)? See Neotoma with ChatGPT.
What Codex provides
- Sandbox environment with project access for each task
- Session-scoped context within the current task execution
- MCP server support via
.codex/config.toml(stdio and HTTP transports with OAuth) - Can itself run as an MCP server for integration with other MCP clients
What Codex doesn't handle
- Memory that persists across task executions; each sandbox starts fresh
- Entity resolution or structured data storage
- Cross-tool access; sandbox state is isolated per task
Deterministic guarantees Neotoma provides
- Persistent memory graph accessible across all Codex tasks
- Deterministic state: same observations always produce the same entity snapshots
- Provenance trail for every stored fact
- CLI fallback for direct terminal access when MCP is not configured
Using them together
Codex provides the execution sandbox; Neotoma provides the persistent state layer. Each sandbox starts fresh, but Neotoma carries structured memory across every task.
Neotoma Codex hooks (optional)
The Neotoma Codex hooks package edits ~/.codex/config.toml to register session start, notification, and session end handlers. Codex exposes fewer hook points than Claude Code, so these focus on the most useful moments: anchoring each session as a conversation, recording notifications as timeline events, and capturing the final assistant reply as a safety net.
Install with neotoma-codex-hooks after npm install -g @neotoma/codex-hooks. MCP still handles agent-driven structured writes.
Getting started
Copia este prompt en Codex para que lea la página de evaluación, revisa tu herramienta, espacio de trabajo y configuración, y juzga si Neotoma encaja en tu flujo real y qué conviene persistir primero.
Lee https://neotoma.io/evaluate. Usa cualquier herramienta, espacio de trabajo y contexto de chat ya disponibles en esta sesión para evaluar mi flujo real. Evita introspección ad hoc en la shell solo para perfilarme; si Neotoma ya está instalado, usa `neotoma doctor --json` para el estado. Luego dime si Neotoma encaja en mi flujo, qué datos conviene persistir primero por valor y qué debería hacer a continuación.Once Neotoma has been evaluated, installed if needed, and activated with your first data, choose an integration path:
Codex documentation
- MCP in Codex (connecting tools via config.toml)
- Config basics (configuration fundamentals)
- CLI reference (command line options)
Before and after: Codex with Neotoma
“Continue where we left off yesterday.”
Resuming based on thread from two weeks ago.
Resuming yesterday’s thread on the migration plan. 3 open tasks remaining.
“What did I commit to with Sarah last week?”
No commitments found.
You committed to sending the architecture doc by Friday. Sarah’s email updated Mar 28.
“How much did we spend on cloud hosting last month?”
No hosting expenses found.
$847 across AWS and Vercel, up 12% from February.
After you connect
Once Neotoma is running, try these starter commands in Codex to see cross-session memory in action:
Store a contact
“Remember that Sarah Chen's email is sarah@newstartup.io — she's the CTO at NewStartup.”
Store a task
“I need to send the architecture doc to Sarah by Friday.”
Recall across sessions
“What do I know about Sarah? What did I commit to doing for her?”
Start with evaluation, see the install guide for more options, MCP reference for MCP setup, CLI reference for terminal usage, and agent instructions for behavioral details.