Mantenha o Mac acordado pela linha de comando

O Keepresso traz uma pequena ferramenta de linha de comando para você controlá-lo pelo terminal, um script de shell, um Makefile, ou um job de CI, sem precisar ir até a barra de menus. O comando é keepresso, e ele funciona de duas formas: pode conversar com o app da barra de menus, ou pode manter o Mac acordado sozinho como o caffeinate nativo.

Instale o comando

Se você instalou o Keepresso com o Homebrew, o comando keepresso já está no seu PATH, nada para fazer:

brew install --cask gyorgysh/keepresso/keepresso

Se você instalou o app pelo DMG, a ferramenta fica dentro do pacote do app e seu PATH ainda não sabe disso. Vincule uma vez:

sudo ln -s /Applications/Keepresso.app/Contents/Helpers/keepresso /usr/local/bin/keepresso

Confira se está funcionando:

keepresso version

Controle o app

Esses comandos são entregues ao app Keepresso, abrindo ele se ainda não estiver rodando. São o irmão programável do menu.

keepresso start                 # inicia uma sessão sem prazo definido
keepresso start --for 90        # inicia uma sessão de 90 minutos
keepresso start --until 18:00   # roda até um horário específico
keepresso stop                  # encerra a sessão atual
keepresso toggle                # ativa ou desativa

Assim, uma tarefa longa pode acordar o Mac quando começa e deixar ele dormir quando termina:

keepresso start
make release
keepresso stop

Leia o status

keepresso status diz se uma sessão está rodando, e o código de saída facilita criar condições em um script:

• 0 o Mac está sendo mantido acordado
• 1 não está
• 2 o app não está rodando

keepresso status && echo "acordado" || echo "dormindo"

Adicione --json para uma resposta legível por máquina:

keepresso status --json

O mesmo estado da sessão também é espelhado em um arquivo, para que uma ferramenta de barra de menus, uma status line, ou um widget possam ler sem abrir nada:

~/Library/Application Support/Keepresso/status.json

Ele traz o estado atual e horários no formato ISO 8601.

Manter acordado sem o app

Às vezes você não quer envolver o app, você só quer que este shell mantenha o Mac acordado, exatamente como o caffeinate. Nesse modo, o próprio processo keepresso segura a asserção de energia, e o Mac fica livre para dormir de novo assim que ele termina.

keepresso -i            # mantém acordado até você apertar Ctrl-C
keepresso -t 3600       # mantém acordado por um número de segundos
keepresso -w 5123       # mantém acordado até o processo 5123 terminar
keepresso -d            # também mantém a tela acordada (combine com os acima)
keepresso -u            # declara atividade do usuário: acorda a tela agora

O padrão mais útil é vincular o tempo acordado à vida de um comando ou de um shell:

keepresso -w $$ &       # fica acordado enquanto esse shell viver

ffmpeg -i in.mov out.mp4 & keepresso -w $!   # segura até o encode terminar

Como essas retenções são asserções de energia reais do macOS, elas aparecem no pmset -g assertions e no próprio painel de Atividade do Keepresso, ao lado de qualquer outro app mantendo o Mac ligado.

Concessões de automação, para scripts e agentes

Um start sem stop pode prender o Mac acordado para sempre se o script travar. Para automação sem supervisão, pegue uma concessão no lugar: uma permissão limitada com um prazo que o dono precisa renovar. Se a ferramenta morrer, a concessão expira e o Mac pode dormir de novo.

ID=$(uuidgen)
keepresso lease acquire --id "$ID" --tool my-script --task "nightly render" --ttl 600
keepresso lease heartbeat --id "$ID"   # renew before half the TTL elapses, on a loop
keepresso lease release --id "$ID"     # done, let the Mac rest
keepresso lease list --json            # every live lease, machine-readable

As concessões ativas aparecem no menu com contagens regressivas, o Keepresso reúne todas, e um tempo de vida máximo (limitado a 7 dias) é um teto que os heartbeats não conseguem estender. O protocolo completo, o servidor MCP e a skill de agente de um clique estão em deixe agentes de IA manterem seu Mac acordado.

Agendamento de despertar

O CLI também pode ler os despertares agendados do sistema, e, com a sua permissão, mudá-los:

keepresso wake status                          # read the schedule, always allowed
keepresso wake set --at "2026-07-24 07:30"     # one-shot wake
keepresso wake set --repeat MTWRF --time 07:30 # repeating wake
keepresso wake clear

O status funciona para qualquer um. O set e o clear aplicam uma mudança em todo o sistema pelo assistente de administrador, então só funcionam enquanto Permitir que a automação mude o agendamento de despertar estiver ligado em Preferências, Automação. Vem desligado por padrão.

Relacionados

• Controle o Keepresso pelo Shortcuts, Raycast ou um script cobre as ações do Shortcuts e o URL scheme keepresso:// para automação sem terminal.
• Keepresso vs Amphetamine, KeepingYouAwake e caffeinate explica como o Keepresso se relaciona com o comando nativo caffeinate.