Deixe agentes de IA manterem o Mac acordado com concessões

Um agente que roda uma tarefa longa durante a noite precisa do Mac acordado enquanto trabalha, e adormecido quando termina. Um simples "manter acordado ligado" acerta a primeira metade e falha na segunda: se a ferramenta travar ou esquecer de desligar, o Mac fica preso acordado para sempre. As concessões de automação resolvem isso. Um script ou um agente de IA adquire uma concessão com prazo, vai renovando enquanto o trabalho roda, e a libera no fim. Se a ferramenta morrer no meio da tarefa, a concessão simplesmente expira e o Mac pode dormir de novo. Nada fica segurando a máquina acordada por acidente.

O Keepresso traz toda a estrutura para isso: os comandos keepresso lease, um servidor MCP que qualquer agente compatível com MCP pode chamar, e uma skill de agente incluída que você instala com um clique.

A detecção observa, uma concessão fala

O Keepresso já tem um gatilho de agente de IA que detecta quando um agente de codificação está de fato trabalhando. Os agentes conhecidos (claude, cursor, codex, gemini, pi e afins) são avaliados pela atividade dos próprios processos, e esse lado não precisa de configuração nenhuma no agente. Conecte o Claude Code, o Cursor, o Codex ou o Antigravity na condição Agente de IA quando quiser o estado exato da sessão, incluindo os agentes embutidos nos apps Cursor e Antigravity, que não têm processo próprio para observar. Só as ferramentas realmente instaladas no seu Mac são oferecidas, e o Keepresso reverifica cada conexão ao longo do tempo, reparando um hook que sumiu ou ficou desatualizado.

Mas a detecção só cobre os agentes que o Keepresso sabe reconhecer, e novos aparecem toda semana. Uma concessão inverte a direção: em vez de o Keepresso adivinhar, o próprio agente diz ao Keepresso quando precisa do Mac acordado, para quê, e por quanto tempo, e depois vai provando que continua vivo. Qualquer ferramenta que consiga rodar um comando ou chamar um servidor MCP consegue fazer isso, seja qual for o nome dela e como funcione por dentro. As duas se complementam bem: a detecção cobre as sessões do dia a dia em que você nem pensou, as concessões cobrem as tarefas longas e deliberadas e tudo que a detecção não consegue enxergar.

Por que uma concessão em vez de keepresso start

keepresso start é um bom interruptor manual, mas a automação quer garantias diferentes:

• Limitada. Uma concessão tem um TTL que o dono precisa renovar, e um tempo de vida máximo (limitado a 7 dias) que os heartbeats nunca conseguem estender. Uma tarefa descontrolada não consegue manter o Mac acordado além do teto.
• Autocorretiva. Sem heartbeat, sem retenção. A concessão de um script que travou expira sozinha.
• Compartilhada com clareza. Várias ferramentas podem manter concessões ao mesmo tempo. O Keepresso as reúne e deixa o Mac dormir depois que a última termina, rodando sua ação de fim de sessão nesse momento, não antes.
• Visível. Cada concessão ativa aparece no menu com sua contagem regressiva, nomeada pela ferramenta e pela tarefa que a tomou.

O ciclo de vida da concessão

Adquira uma concessão quando a tarefa começa. Você escolhe o id (um UUID), nomeia a ferramenta e a tarefa, e define o TTL em segundos:

ID=$(uuidgen)
keepresso lease acquire --id "$ID" --tool my-script --task "nightly render" --ttl 600

Envie um heartbeat antes de metade do TTL passar, em um loop enquanto o trabalho durar. Um heartbeat também pode ajustar o TTL:

keepresso lease heartbeat --id "$ID"            # renew with the same TTL
keepresso lease heartbeat --id "$ID" --ttl 300  # renew and shorten it

Libere quando a tarefa terminar, para que o Mac não fique esperando o resto do TTL:

keepresso lease release --id "$ID"

E liste o que está ativo, o seu e o de todos os outros:

keepresso lease list --json

Todo comando aceita --json para saída legível por máquina, e os códigos de saída foram feitos para scripts: 0 ok, 2 o app não está rodando, 3 a concessão não foi encontrada ou já terminou, 4 as concessões estão desligadas nas Preferências.

As concessões são governadas por um interruptor em Preferências, Automação, ligado por padrão. Desligue-o e todo acquire é recusado com o código de saída 4, para que a automação nunca possa passar por cima da sua escolha.

Veja e pare tudo pelo menu

As concessões ativas aparecem no cartão de status do painel do menu, cada uma com sua contagem regressiva. Você continua no comando: Parar encerra todas de uma vez, e o Mac fica livre para dormir de novo.

Ensine seu agente com um clique

Você não precisa explicar nada disso ao seu agente na mão. O pacote do app traz uma skill de manter acordado pronta que ensina ao agente todo o protocolo, tanto a linha de comando keepresso quanto o servidor MCP, além de quando usá-la: antes de um build longo, uma renderização, um download, ou uma execução noturna. Em Preferências, Automação, instale-a direto do disco na pasta de skills do seu agente. Para agentes sem uma, o Keepresso copia a skill completa como instruções prontas para colar: cole-as no agente uma vez e o protocolo é aprendido, ou salve-as em um arquivo de configuração global que seu agente sempre lê, como CLAUDE.md ou AGENTS.md, para que toda sessão futura já saiba como e quando manter o Mac acordado. A skill também fica no pacote em Keepresso.app/Contents/Resources/AgentSkill/keep-awake se você preferir conectar tudo por conta própria.

O servidor MCP

Para agentes que falam o Model Context Protocol, o pacote traz o keepresso-mcp:

/Applications/Keepresso.app/Contents/Helpers/keepresso-mcp

Ele expõe ferramentas para adquirir, dar heartbeat, liberar e listar concessões, ler o status do Keepresso, e ler o agendamento de despertar do sistema. O MCP é um protocolo aberto, então isso não se limita a agentes de codificação: qualquer app compatível com MCP pode manter a própria concessão e manter o Mac vivo enquanto trabalha. Preferências, Automação tem trechos de configuração prontos para copiar para Claude Code, Gemini CLI, Grok e Codex. Para o Claude Code, resume-se a um comando:

claude mcp add keepresso -- /Applications/Keepresso.app/Contents/Helpers/keepresso-mcp

Agendamentos de despertar para automação, opcional

A automação também pode ler quando o sistema está agendado para acordar em seguida, e, se você permitir, mudar esse agendamento:

keepresso wake status                          # always allowed, for anyone
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

A leitura é sempre permitida. Mudar o agendamento só funciona enquanto Permitir que a automação mude o agendamento de despertar estiver ligado em Preferências, Automação. Vem desligado por padrão, porque um despertar agendado é uma mudança em todo o sistema aplicada pelo assistente de administrador. O servidor MCP carrega as ferramentas correspondentes sob a mesma regra.

Acorde o Mac para execuções de IA agendadas

As concessões e o CLI cobrem o trabalho que já está rodando. Mas parte do trabalho dos agentes é agendado para depois: uma rotina do Claude Desktop configurada para rodar às 3 da manhã, uma automação do Codex numa cadência noturna. Se o Mac já tiver dormido até lá, a execução simplesmente é pulada.

Execuções de IA agendadas fecha essa lacuna sem precisar de script nenhum. Ative em Preferências, Automação, Execuções de IA agendadas, e depois ligue cada ferramenta para a qual você quer que o Mac acorde. O Keepresso lê as tarefas recorrentes que aquela ferramenta tem agendadas, acorda o Mac alguns minutos antes de cada uma, e o mantém acordado por uma janela curta para que a execução aconteça mesmo com a tampa fechada.

Nada é importado até você ligar uma ferramenta, e cada rotina mantém seu próprio interruptor, para que você possa acordar para o relatório noturno e ignorar o resto. Se a lista vier vazia, a ferramenta ainda não tem nenhuma tarefa recorrente local.

• Você opta por ferramenta. O Claude Desktop e o Codex começam desligados, então nada que você não usa nunca acorda o Mac. Ele lê só o agendamento e o nome da tarefa, nunca o prompt dela.
• Só agendamentos locais. Rotinas na nuvem rodam nos servidores do fornecedor, seu Mac estando acordado ou não, então essas são ignoradas. Isso é para as execuções que precisam do seu Mac ligado.
• Para uma execução mais longa, combine com uma concessão: a janela de despertar dá início à execução, e o agente mantém uma concessão para o Mac ficar acordado até o trabalho de fato terminar.

Por baixo dos panos, isso usa a mesma engrenagem de despertar agendado que os comandos keepresso wake do CLI acima, então precisa do assistente de administrador e é confiável na tomada (na bateria o firmware pode pular o despertar).

O que você precisa

• Keepresso 1.17 ou mais novo para concessões, o servidor MCP e os comandos de despertar do CLI; 1.18 ou mais novo para Execuções de IA agendadas. Passos de instalação: primeiros passos.
• Para o CLI em uma instalação por DMG, vincule o comando uma vez.
• Para mudanças no agendamento de despertar e para Execuções de IA agendadas, o assistente de administrador e os interruptores opcionais acima.

Relacionados

• Mantenha o Mac acordado pela linha de comando cobre o resto do CLI keepresso.
• Mantenha o Mac acordado durante builds longos mostra as abordagens baseadas em gatilhos para tarefas que você mesmo roda.
• Rodando agentes em um Mac sempre ligado? O MyAgens dá a ele uma equipe de agentes Claude Code que você comanda pelo Telegram.