Anti-Sleep (caffeinate do macOS)

Quando Usar

• Use quando o usuário quiser que o Mac permaneça acordado durante uma tarefa supervisionada longa.
• Use quando uma compilação, download ou execução de automação não deve ser interrompida pelo modo de suspensão.

Mantenha o Mac acordado usando o comando embutido caffeinate. Nenhuma instalação é necessária.

Início Rápido — O Comando Padrão

caffeinate -d -i -t 7200    # full power: screen stays on + no idle sleep, for 2 hours

A duração é -t <seconds>: 2h = 7200, 7h = 25200, durante a noite (9h) = 32400.

Níveis de Agressividade

Use -d -i -t <seconds> por padrão, a menos que o usuário diga o contrário.

Vincular a um Processo em Vez de um Timer

caffeinate -d -i -w <PID>          # stays awake until that process exits (great for builds)
caffeinate -i npm run build       # wraps a command; exits when the command finishes

Executar em um Terminal Visível (Painel do cmux)

Prefira executar no painel do terminal do usuário para que seja visível e fácil de usar Ctrl+C. No cmux (leia a habilidade cmux primeiro se estiver interagindo com painéis):

cmux send --surface surface:<N> "caffeinate -d -i -t 25200\n"

Caso contrário, execute como uma tarefa Bash em segundo plano. Nunca bloqueie seu próprio shell em primeiro plano com ele.

Verificar e Monitorar

pgrep -fl caffeinate                       # is it running? shows exact flags
ps -o etime= -p <PID>                      # how long it's been running
pmset -g assertions    # inspect PreventUserIdleSystemSleep / PreventUserIdleDisplaySleep        # confirm sleep assertions are active

Atenção: caffeinate não imprime nada e mantém o prompt — parece "travado" ou como se o Enter não tivesse sido pressionado. Ele não está travado. Verifique com pgrep, não olhando para o terminal.

Expiração: com -t, ele sai silenciosamente quando o tempo acaba — sem notificação. Se o usuário perguntar "ainda está ligado?" depois de horas, verifique pgrep primeiro; ele pode simplesmente ter expirado.

Luz de Fundo do Teclado

caffeinate não consegue manter a luz de fundo do teclado acesa — ela tem seu próprio timer de inatividade sem CLI/API no Apple Silicon (pesquisado em 2026-07). A correção é manual, única: Ajustes do Sistema > Teclado > "Desligar luz de fundo do teclado após inatividade" > Nunca.

Parar Antecipadamente

kill <recorded-caffeinate-PID>    # or Ctrl+C in the pane running this task

Registre o PID do processo iniciado para esta tarefa; verifique seu comando antes de pará-lo. Não pare sessões de caffeinate não relacionadas por um padrão amplo.

Após iniciar: confirme ao usuário o PID, as flags e o tempo de relógio de parede em que ele expirará.

Limitações

• Adaptado de davidondrej/skills; verifique caminhos locais, ferramentas, credenciais e recursos do agente antes de agir.
• Para comandos, acesso remoto, agendamento, automação de navegador ou fluxos de trabalho de alteração de arquivos, obtenha aprovação explícita do usuário e confirme o ambiente de destino primeiro.