Código abierto · Agentes de IA

Servidor MCP de memoria persistente para Codex

Memoria local first para Codex mediante un servidor MCP con SQLite, usando recuperacion progresiva con busqueda, timeline y detalles completos bajo demanda.

Logo de codex-mem. Wordmark de codex-mem.

codex-mem es un servidor MCP local first, respaldado por SQLite, para flujos de trabajo con OpenAI Codex. Preserva memoria util entre sesiones para que decisiones, restricciones y fixes no se pierdan al reiniciar una sesion.

Que es esto

Es un servidor MCP practico que guarda memoria del proyecto en SQLite local y expone herramientas de recuperacion pensadas para el trabajo diario.

Para quien es

  • Desarrolladores que usan OpenAI Codex en terminal o editor
  • Equipos que prefieren memoria local en lugar de servicios alojados
  • Builders que necesitan handoffs consistentes entre sesiones

Get it

Compatibilidad

  • Clientes y flujos compatibles con MCP (incluyendo setups de Codex con MCP)
  • SQLite local, sin requerir base de datos externa
  • Uso local first con control sobre almacenamiento y retencion

Por que importa

Muchas sesiones de agentes son cortas. Cuando termina la sesion, el contexto del proyecto suele desaparecer. Eso genera explicaciones repetidas, errores repetidos y handoffs lentos.

codex-mem define un contrato simple:

  • Guardar entradas pequenas y de alto valor (decisiones, fixes, restricciones).
  • Recuperar de forma progresiva, no cargando todo de golpe.
  • Mantener los datos en local en una base SQLite bajo tu control.

Que ofrece

Capacidades principales:

  • Almacenamiento SQLite con busqueda full text para recuperacion rapida.
  • Flujo progresivo: buscar, ampliar contexto, y luego traer detalles completos.
  • Ingestion de docs con deduplicacion por hash para re ejecuciones seguras.
  • Reportes de retencion para evitar que la memoria se vuelva ruido.
  • Helpers opcionales para capturar resumenes y commits.

Inicio rapido

Instalacion en un comando

En la raiz del repo:

npm run mcp:install

Setup manual

npm install
export MEMORY_DB_PATH=.memory/codex-mem.db
npm run migrate
npm run mcp:start

Configuracion MCP en VS Code

Valores recomendados:

  • Name: codex-mem
  • Transport: STDIO
  • Command: npm
  • Arguments: run, mcp:start, --silent
  • Environment: MEMORY_DB_PATH=.memory/codex-mem.db
  • Working directory: ruta absoluta al repo codex-mem

Como funciona la recuperacion (progresiva)

Flujo recomendado:

  1. search: descubrimiento rapido.
  2. timeline: ampliar contexto alrededor de un anchor.
  3. get_entries: traer detalles completos solo para IDs seleccionados.

Esto mantiene el costo bajo incluso cuando crece la base de memoria.

Tools MCP (alto nivel)

Tools comunes:

  • save_memory
  • search
  • timeline
  • get_entries
  • ingest_docs
  • retention_dry_run

Automatic mode (opcional)

Un wrapper ligero:

npm run auto:mode -- start --ingest --project codex-mem
npm run auto:mode -- end --summary "Session handoff summary."
npm run auto:mode -- commit

Errores comunes

  • No guardar secrets en la memoria. Los secrets deben ir a un gestor de secretos o env files locales.
  • No guardar dumps largos. Mejor notas cortas y estructuradas con un titulo claro.
  • No ignorar retencion. Ejecuta reportes para mantener la base con alto valor.

Código fuente en GitHub (Se abre en una pestaña nueva)

Comentarios

Cargando comentarios.

    Escribe un comentario

    Tus opciones

    Controles de privacidad

    Este sitio no usa cookies opcionales, así que no hay nada que aceptar o rechazar. Aquí puedes ver qué ocurre y qué puedes cambiar.

    Leer la política de cookies
    Preferencia de tema
    Si eliges el modo claro u oscuro, este sitio guarda esa elección en el navegador. Puedes borrarla abajo para volver a seguir la configuración del sistema.
    Vídeos y publicaciones externos
    Desactivados por defecto. El proveedor solo se carga cuando pulsas su botón y solo durante esa visita a la página. Recarga para cerrarlo.
    Protección de formularios
    Cloudflare Turnstile se carga solo al enviar un formulario. La comprobación puede completarse sin mostrar un reto.
    Estadísticas de visitas
    Cloudflare Web Analytics cuenta visitas sin cookies ni guardar una elección en tu dispositivo.