Si usás Codex CLI todos los días, seguro viviste esto: tu lista de sesiones se convierte de a poco en un cementerio. El bugfix del martes pasado. Ese spike que abandonaste por la mitad. Tres sesiones de “prueba rápida” casi idénticas que nunca nombraste. Ninguna te sirve más, pero todas siguen ahí — y cada vez que corrés codex resume para encontrar la única sesión que realmente te importa, tenés que pasar por arriba de toda la basura.
OpenAI sacó una solución para exactamente este problema, y casi nadie la está usando todavía: el archivado de sesiones. Acá va el workflow completo — archivar, restaurar, y cómo se lleva con resume y fork.
El problema que archive realmente resuelve
codex resume --last encuentra la sesión más reciente que coincide leyendo tu state DB local. En una instalación nueva eso es instantáneo. Después de unos meses de uso intenso, con cientos de sesiones apiladas localmente, el restore se vuelve notablemente más lento — las release notes recientes de OpenAI mencionan explícitamente que aceleraron resume --last en “historiales locales grandes”. Cuantas más sesiones muertas arrastrás, más peso carga cada búsqueda.
El archivado es la limpieza. Saca una sesión de tu lista activa sin borrar nada. El trabajo sigue ahí si lo necesitás de vuelta — simplemente está fuera del camino.
Archivar desde adentro de una sesión
El camino más simple es el slash command. Dentro de una sesión activa de Codex, escribís:
/archive
Codex te pide confirmación, después archiva la sesión actual y cierra la TUI. Un detalle que conviene saber: archiva y sale en un solo movimiento. Así que /archive no es un comando de “ordeno un poco y sigo trabajando” — es la forma de cerrar una sesión que ya terminaste, de manera limpia. (Si solo querés salir sin archivar, eso sigue siendo /quit o /exit.)
Codex además deshabilita /archive mientras hay una task corriendo. No podés archivar una sesión en medio de un turn — primero terminá o cancelá el trabajo.
Archivar desde la línea de comandos
No hace falta estar dentro de una sesión para archivarla. Desde tu shell:
codex archive
codex unarchive
codex archive mueve una sesión al estado archivado; codex unarchive la trae de vuelta a tu lista activa. Esta es la mitad que hace que archive sea genuinamente útil para limpiar — podés ordenar tu historial en lote desde afuera de la TUI, y después restaurar cualquier sesión en el momento en que la vuelvas a necesitar.
La regla que evita accidentes: archivado ≠ borrado
Esta es la parte que hace que archivar sea seguro de usar sin miedo. Las sesiones archivadas están protegidas de resume y fork hasta que las restaures.
En la práctica eso significa:
- Una sesión archivada no aparece cuando hacés
resume— ese es justamente el punto, está fuera de tu lista activa. - No podés hacer
forkpor accidente de una sesión archivada hacia una rama nueva. Codex lo bloquea. - No se destruye nada. La sesión está intacta; solo está detrás de un
unarchiveprevio.
Así que el modelo mental es claro: archive es un “guardá esto” reversible, no un “tirá esto” destructivo. Si venías dudando en limpiar sesiones viejas porque tenías miedo de perder contexto que podrías necesitar después — ese miedo no aplica acá. Archivá tranquilo. Restaurá cuando realmente lo necesites.
Un workflow que mantiene la lista usable
Juntando todo, acá va un hábito que vale la pena adoptar:
- Terminás una pieza de trabajo → la archivás con
/archive. Cerrar una sesión que ya terminaste debería ser el final por defecto, no dejarla abierta “por las dudas”. - Una vez por semana, hacé
codex archivede las sesiones muertas obvias — spikes abandonados, pruebas descartables, cualquier cosa que sabés que no vas a volver a tocar. - Cuando necesites una sesión archivada de vuelta, hacé
codex unarchivey vuelve a tu lista activa, sin tocar nada.
El beneficio es que resume y resume --last se mantienen rápidos y te muestran de verdad las sesiones en las que estás trabajando ahora — no seis meses de ruido acumulado.
Una salvedad honesta
Archive maneja tu lista de sesiones local. Es una herramienta de housekeeping, no una estrategia de backup ni un mecanismo de sync — no trates al archivado como “guardar” trabajo en algún lugar seguro. Commiteá tu código de la forma normal. Lo que archive hace bien, y todo lo que dice hacer, es mantener limpia tu lista de sesiones del día a día y rápidos tus restores. Para ese trabajo puntual, es el feature que la mayoría de los usuarios intensos no sabe que ya tiene.