Como manter o Codex rodando a noite toda em um Mac

Por que uma sessão noturna do Codex trava

O macOS foi feito para colocar um notebook ocioso para dormir. Depois do timer de inatividade, ou no instante em que você fecha a tampa, o sistema suspende — e todo processo em execução suspende junto, incluindo o Codex.

Nada se perde quando isso acontece. O agente para exatamente onde estava e espera o próximo wake. Mas aquela sessão do Codex de várias horas que você queria pronta pela manhã mal começou, e a noite já foi.

Dois mecanismos diferentes são os culpados, e cada um exige uma solução diferente. O idle sleep dispara no próprio timer sempre que você se afasta com a tampa aberta. O sleep de tampa fechada (clamshell) é outra história — entra em ação em segundos assim que você fecha a tampa, com ou sem timer. Manter o Codex vivo a noite toda significa lidar com os dois, e é exatamente aí que um simples comando caffeinate deixado rodando resolve só metade do problema.

O jeito gratuito: caffeinate para o idle sleep, pmset para a tampa

O caffeinate já vem com o macOS, sem precisar instalar nada. Basta colocar na frente de como você já inicia o Codex — caffeinate -i codex — ou, se o Codex já estiver rodando, apontar para o processo existente com caffeinate -i -w $(pgrep -x codex). Nos dois casos ele segura a mesma assertion do IOKit, a PreventUserIdleSystemSleep (é isso que a flag -i pede), que impede o idle sleep, e se libera sozinha no instante em que o processo codex termina. É uma solução real e gratuita para a metade 'tampa aberta' de uma sessão noturna.

A metade 'tampa fechada' precisa de outra ferramenta, porque o caffeinate não mexe no clamshell sleep — fechar a tampa ainda suspende o Mac em segundos mesmo com o caffeinate rodando. A solução documentada é sudo pmset -a disablesleep 1, que diz ao macOS para ignorar completamente o sensor da tampa, e é exatamente o mesmo mecanismo que o LidRun automatiza por baixo dos panos. Se o Mac estiver na tomada com um monitor externo conectado, o macOS já pula o clamshell sleep sozinho, sem precisar de toggle nenhum — mas isso só ajuda em cima de uma mesa, não para um notebook fechado e deixado em cima do criado-mudo.

Juntando tudo, a receita totalmente gratuita para a noite é: caffeinate -i codex antes de começar a sessão, sudo pmset -a disablesleep 1 antes de fechar a tampa, e sudo pmset -a disablesleep 0 quando terminar. Funciona. O que ela não faz é saber nada sobre o que está acontecendo dentro do Mac.

Onde a solução gratuita começa a faltar

O pmset disablesleep é uma configuração persistente e válida para a máquina inteira, não algo limitado à sessão de hoje à noite. Ele não tem a menor ideia de que o Codex terminou às 2h da manhã — fica exatamente como você deixou até que algo o volte para 0, reboot incluso. Esqueça o comando de fechamento pela manhã e o Mac vai ficar feliz o dia inteiro com a tampa fechada e acordado, à toa.

A mesma limitação vale para ferramentas gráficas de keep-awake como Amphetamine, KeepingYouAwake, Caffeine ou Lungo — uma forma limpa e gratuita de bloquear o idle sleep pela menu bar em vez de um comando de terminal, e uma boa escolha para uma sessão com a tampa aberta. Elas esbarram na mesma parede que o caffeinate: nenhum tratamento de clamshell, nenhuma percepção de bateria ou temperatura.

Mais importante ainda: nem o caffeinate, nem as ferramentas gráficas, nem o pmset sabem qualquer coisa sobre bateria ou calor. Todos eles mantêm o Mac acordado incondicionalmente. Se o carregador se solta durante a noite, o caffeinate mantém a assertion ativa até a bateria zerar. Se o disablesleep está ligado e a tampa fechada acaba debaixo de um edredom ou dentro de uma mochila, nada entra em ação enquanto a temperatura sobe — essa é a troca que um wake lock cego faz: confiável, mas sem noção de quando parar.

Essa lacuna — mecanismos reais, mas nenhuma noção de segurança — é exatamente o que uma sessão noturna precisa fechar.

Como o LidRun mantém o Codex rodando a noite toda

Para o idle sleep, o LidRun segura a mesma assertion PreventUserIdleSystemSleep que o caffeinate usa — nada de novo aqui, é o mecanismo já conhecido e testado.

Para a tampa, o LidRun automatiza o mesmo toggle do pmset disablesleep, mas pede a autorização uma única vez, por um prompt nativo de administrador do macOS, e sempre emparelha a ação: liga quando você inicia uma sessão de Closed-Lid, desliga de novo quando você para, quando fecha o app, e reconcilia na próxima abertura se o app tiver travado no meio da sessão — então não fica pendurado do jeito que um comando de terminal esquecido pode ficar.

No caso específico do Codex, o Auto Mode já vem com codex na lista de observação padrão — nada para digitar. Ele checa a lista de processos a cada 10 segundos; no instante em que o codex para de rodar, a trava libera e o Mac volta a poder dormir nos timers normais. Essa é a versão honesta da promessa: agente rodando, mantém acordado; agente terminou, dorme — não um wake lock que sobrevive à coisa que ele estava segurando.

As proteções são o que realmente diferencia do caminho gratuito. O auto-stop de bateria vem em 20% por padrão e você pode ajustar, mas também existe um piso rígido — por volta de 4% — que dispara não importa o que você tenha configurado, então uma sessão não consegue drenar a bateria até zero. Quanto a calor, o LidRun lê a temperatura real do SMC e o throttle da CPU, em vez de depender só da API grosseira de thermal-state do sistema, tratando o Mac como sob pressão real por volta de 98°C ou com throttle abaixo de 50%, e recuando por volta de 100°C ou throttle abaixo de 30%. Nada disso afirma que uma tampa fechada não pode esquentar durante a noite — pode, uma tampa fechada retém calor por design — as proteções existem para liberar antes que isso vire um desligamento por temperatura, não para prometer que nunca chega perto.

Configurando uma sessão noturna do Codex no LidRun

Ative o Auto Mode. O Codex já está na lista de observação por padrão, então não há nada para configurar antes de começar a sessão — inicie o Codex e o LidRun pega ele na próxima varredura.

Se você vai fechar a tampa, ative o Closed-Lid mode junto. É esse toggle que coloca o par do pmset disablesleep em vigor durante a sessão, e o remove de novo quando a sessão termina.

Em Settings, deixe a porcentagem de auto-stop de bateria e o thermal guard ligados — eles vêm ativados por padrão por um motivo. Se você preferir limitar tudo a uma duração fixa em vez de deixar em aberto, o Timer mode faz isso na própria agenda, liberando a trava quando o tempo expira, esteja o Codex ainda rodando ou não. Auto Mode e Closed-Lid fazem parte do LidRun Pro; os modos básicos Keep Awake, Timer e Charging-only — com o auto-stop de bateria incluso — são gratuitos e sem limite de sessão.

Quando vale a pena, e quando não vale

Se a tarefa do Codex termina em poucos minutos, nada disso é necessário — deixe a tampa aberta e deixe rodar.

Manter rodando a noite toda faz sentido para as tarefas longas: um refactor grande, um lote de tarefas de agente, qualquer coisa que dependa de um modelo lento ou de um repositório grande — do tipo que você quer pronto pela manhã sem precisar ficar de olho.

Vale mais a pena ligar quando a alternativa é deixar a tampa escorada aberta só para a sessão sobreviver até você acordar, principalmente com o Mac na bateria ou em algum lugar que retenha calor durante a noite.

Checklist para uma configuração noturna segura

Mantenha o Mac na tomada. Sessões noturnas na bateria são possíveis — o auto-stop de bateria baixa vale nos dois casos — mas a energia da tomada tira a questão do consumo de cena por completo.

Coloque-o sobre uma superfície dura, plana e ventilada. Uma tampa fechada já retém um pouco de calor por design; uma cama, uma almofada de sofá ou uma mochila piora isso, e nenhum software conserta uma circulação de ar que não existe.

Deixe as proteções ligadas e permita que a sessão se encerre sozinha — seja porque o Codex terminou antes, a bateria caiu abaixo do seu piso, ou o calor subiu — em vez de depender de estar acordado para parar você mesmo.