Sin resume en Codex CLI, construí uno para continuar rápido con codex-history-list

Codex CLI es un agente de codificación con IA que vive en tu terminal, pero todavía no existe una función oficial para reanudar sesiones.

Si una sesión se cae o quieres continuarla más tarde, no puedes retomarla tal cual, lo cual resulta poco práctico. Como solución temporal, creé una pequeña CLI que lista sesiones pasadas para reanudar manualmente en segundos: codex-history-list. Asumo que Codex CLI incorporará reanudar más adelante, por eso no lo publiqué en npm; es open source para uso personal y con foco inicial en macOS.

Nota: según el estado indicado por la comunidad a 2025-09-03, no hay comando oficial slash resume. Hay solicitudes de función en GitHub.

Problema: continuar una sesión es complicado. Al cerrar la CLI, el contexto se pierde, lo que dificulta tareas largas o retomar más tarde. Codex CLI guarda cada sesión como JSONL en la carpeta ~/.codex/sessions, pero no ofrece un flujo oficial para cargar y reanudar esos registros.

Antecedentes: existe una puerta a una reanudación experimental. Codex CLI tiene un archivo de configuración en ~/.codex/config.toml y un indicador -c key=value para anular ajustes temporalmente. En la plantilla aparece la clave experimental_resume. Si pasas la ruta a un JSONL al iniciar, puedes simular una reanudación de la sesión, aunque es experimental y conviene usarla con cautela.

Solución: usa codex-history-list para elegir rápido el log correcto y reanudar. La herramienta recorre de forma recursiva ~/.codex/sessions y analiza de forma ligera cada JSONL para mostrar una tabla con lo esencial: cwd del proceso de esa sesión, primera pregunta del usuario omitiendo bloques de entorno o instrucción para mayor legibilidad, hora a partir de mtime o timestamp interno y ruta completa sin truncar lista para copiar.

Extras útiles: alineación segura con multibyte, salida en formato JSON, filtros por fecha y directorio, ordenación por diferentes campos y más. En el README del repositorio encontrarás ejemplos de salida, opciones y notas de diseño.

Cómo usarlo paso a paso

1 Instalación orientada a uso local no está en npm

git clone https://github.com/shinshin86/codex-history-list.git cd codex-history-list npm i npm run build node dist/cli.js --help

Nota: herramienta pensada para uso local, no publicada en npm.

2 Lista tus sesiones

node dist/cli.js node dist/cli.js --limit 20 node dist/cli.js --since 2025-08-01 --before 2025-09-01 node dist/cli.js --cwd-filter /Users/tuusuario/projects/tuapp node dist/cli.js --json

La tabla muestra time, cwd, ask y path. Los campos cwd y ask se recortan a nivel visual para facilitar la lectura, mientras que path se mantiene completo para copiar y pegar sin sorpresas.

3 Lanza Codex CLI con la ruta elegida reanudación experimental

Cuando identifiques la fila objetivo, copia el valor de path y lanza Codex así:

codex -c experimental_resume=/Users/you/.codex/sessions/2025/08/31/rollout-2025-08-31T17-06-00-...jsonl

-c key=value es la vía oficial para anular configuración al arrancar. La clave experimental_resume existe en la plantilla como experimental. Combinándolas, puedes iniciar Codex con el contexto de tu sesión anterior ya cargado.

Nota: para instalar Codex CLI usa npm i -g @openai/codex o brew install codex.

Resumen y por qué importa

Problema: no hay reanudar oficial, por lo que continuar sesiones pasadas es tedioso. Premisa: Codex guarda sesiones como JSONL en ~/.codex/sessions. Enfoque: facilitar encontrar los logs guardados y arrancar Codex con la clave experimental para una pseudo reanudación. Herramienta: codex-history-list es OSS para uso personal con foco en macOS, no está en npm.

Cuando exista un comando slash resume o un listado de sesiones integrado, esta utilidad habrá cumplido su papel. Si te interesa el avance oficial, revisa Issues y Discussions del repositorio de Codex.

Cómo puede ayudarte Q2BSTUDIO

En Q2BSTUDIO somos una empresa de desarrollo con foco en software a medida y aplicaciones a medida, especialistas en inteligencia artificial, ia para empresas y agentes IA, además de ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio y power bi, así como automatización de procesos de extremo a extremo. Si necesitas integrar flujos con agentes de IA, orquestar históricos de interacción o diseñar herramientas para desarrolladores, podemos ayudarte a hacerlo realidad. Descubre nuestros servicios de inteligencia artificial o explora nuestro desarrollo de aplicaciones a medida para llevar tus ideas a producción con calidad y seguridad.

Referencias útiles

Repositorio de codex-history-list con guía de uso, funciones y receta de reanudación: github.com/shinshin86/codex-history-list

OpenAI Codex CLI repositorio y documentación oficial: github.com/openai/codex

Plantilla de configuración con la clave experimental experimental_resume discutida por la comunidad, y menciones sobre la carpeta de sesiones ~/.codex/sessions en Issues y Discussions del repo.

Intención del autor

Hasta que llegue una función oficial de reanudar, la meta es el camino más corto: un listado legible más una receta de lanzar con ruta de log. Sin florituras, pero con la rapidez necesaria para encontrar el JSONL correcto sin perderse.