Se você usa Codex CLI todos os dias, com certeza viveu isso: sua lista de sessões se torna pouco a pouco um cemitério. O bugfix de terça passada. Aquele spike que você abandonou no meio. Três sessões de “teste rápido” quase idênticas que você nunca nomeou. Nenhuma serve mais, mas todas continuam lá — e cada vez que você roda codex resume para encontrar a única sessão que realmente importa, tem que passar por cima de todo o lixo.
OpenAI lançou uma solução para exatamente esse problema, e quase ninguém está usando ainda: o arquivamento de sessões. Aqui vai o workflow completo — arquivar, restaurar, e como funciona com resume e fork.
O problema que archive realmente resolve
codex resume --last encontra a sessão mais recente que corresponde lendo seu state DB local. Em uma instalação nova isso é instantâneo. Depois de alguns meses de uso intenso, com centenas de sessões acumuladas localmente, o restore se torna notavelmente mais lento — as notas de versão recentes do OpenAI mencionam explicitamente que aceleraram resume --last em “históricos locais grandes”. Quanto mais sessões mortas você carrega, mais peso cada busca tem.
O arquivamento é a limpeza. Tira uma sessão da sua lista ativa sem deletar nada. O trabalho continua lá se você precisar dele de volta — simplesmente está fora do caminho.
Arquivar de dentro de uma sessão
O caminho mais simples é o slash command. Dentro de uma sessão ativa do Codex, você digita:
/archive
Codex pede confirmação, depois arquiva a sessão atual e fecha a TUI. Um detalhe que vale saber: arquiva e sai em um único movimento. Então /archive não é um comando de “organizo um pouco e continuo trabalhando” — é a forma de fechar uma sessão que você já terminou, de maneira limpa. (Se você só quer sair sem arquivar, isso continua sendo /quit ou /exit.)
Codex também desabilita /archive enquanto há uma task rodando. Você não pode arquivar uma sessão no meio de um turn — primeiro termine ou cancele o trabalho.
Arquivar pela linha de comando
Não é necessário estar dentro de uma sessão para arquivá-la. Do seu shell:
codex archive
codex unarchive
codex archive move uma sessão para o estado arquivado; codex unarchive a traz de volta para sua lista ativa. Esta é a parte que torna archive genuinamente útil para limpeza — você pode organizar seu histórico em lote de fora da TUI, e depois restaurar qualquer sessão no momento em que precisar dela novamente.
A regra que evita acidentes: arquivado ≠ deletado
Esta é a parte que torna archivar seguro de usar sem medo. As sessões arquivadas estão protegidas de resume e fork até que você as restaure.
Na prática isso significa:
- Uma sessão arquivada não aparece quando você faz
resume— esse é justamente o ponto, está fora da sua lista ativa. - Você não pode fazer
forkpor acidente de uma sessão arquivada para um novo ramo. Codex bloqueia. - Nada se destrói. A sessão está intacta; só está atrás de um
unarchiveprévio.
Então o modelo mental é claro: archive é um “guarde isto” reversível, não um “jogue isto fora” destrutivo. Se você estava na dúvida em limpar sessões antigas porque tinha medo de perder contexto que poderia precisar depois — esse medo não se aplica aqui. Archive tranquilo. Restaure quando realmente precisar.
Um workflow que mantém a lista usável
Juntando tudo, aqui vai um hábito que vale a pena adotar:
- Você termina um trabalho → o arquiva com
/archive. Fechar uma sessão que você já terminou deveria ser o final por padrão, não deixá-la aberta “por precaução”. - Uma vez por semana, faça
codex archivedas sessões mortas óbvias — spikes abandonados, testes descartáveis, qualquer coisa que você sabe que não vai tocar novamente. - Quando você precisar de uma sessão arquivada de volta, faça
codex unarchivee ela volta para sua lista ativa, sem tocar em nada.
O benefício é que resume e resume --last se mantêm rápidos e mostram de verdade as sessões em que você está trabalhando agora — não seis meses de ruído acumulado.
Uma ressalva honesta
Archive gerencia sua lista de sessões local. É uma ferramenta de limpeza, não uma estratégia de backup nem um mecanismo de sync — não trate o arquivamento como “guardar” trabalho em algum lugar seguro. Faça commit do seu código da forma normal. O que archive faz bem, e tudo o que diz fazer, é manter sua lista de sessões do dia a dia limpa e seus restores rápidos. Para esse trabalho específico, é o feature que a maioria dos usuários intensos não sabe que já tem.