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 incluem Claude, Cursor, Codex, Gemini, Grok, Antigravity, Hermes Agent, Kilo Code, OpenCode, DeepSeek Harness, LM Studio Bionic, pi, Kimi Code, Qwen Code, Muse Code, Devin CLI e outros. Ferramentas sem uma conexão mais profunda são avaliadas por evidências do processo ou do armazenamento de conversas, e esse lado não precisa de configuração nenhuma no agente.

Conecte o Claude Code, o Cursor, o Codex, o Antigravity ou o Grok na condição Agente de IA quando quiser o estado exato da sessão. As conversas são acompanhadas separadamente, incluindo chats dentro de apps desktop que compartilham um único processo host, para que uma conversa ociosa não herde o trabalho de outra e uma parada perdida não mantenha o Mac acordado pela vida do app. 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, não importa o nome, 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, ou um job do tokenstat.ai que precisa deste Mac. 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 plataforma. O Claude Desktop, o Codex e o tokenstat.ai começam cada um desligado, então nada que você não usa nunca acorda o Mac. O Keepresso lê só o agendamento e o nome da tarefa, nunca o prompt dela.
• Só agendamentos locais. Rotinas na nuvem rodam nos servidores do fornecedor mesmo se o seu Mac estiver dormindo, 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 do Claude Desktop e do Codex; 1.21 ou mais novo para jobs do tokenstat.ai e a detecção ampliada de agentes. 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.