Lascia che gli agenti IA tengano sveglio il Mac

Un agente che esegue un lavoro lungo durante la notte ha bisogno che il Mac sia sveglio mentre lavora, e che si addormenti quando ha finito. Un semplice "mantieni sveglio" copre la prima metà e fallisce la seconda: se lo strumento va in crash o si dimentica di disattivarlo, il Mac resta inchiodato sveglio per sempre. I lease di automazione risolvono questo. Uno script o un agente IA acquisisce un lease con un limite di tempo, continua a rinnovarlo mentre il lavoro è in corso, e lo rilascia alla fine. Se lo strumento muore a metà del lavoro, il lease scade e basta, e il Mac può tornare a dormire. Niente resta a tenere su la macchina per sbaglio.

Keepresso include tutto il necessario per questo: i comandi keepresso lease, un server MCP che qualsiasi agente compatibile con MCP può chiamare, e una skill per agenti integrata che puoi installare in un clic.

Il rilevamento osserva, un lease parla

Keepresso ha già un trigger per agenti IA che rileva quando un agente di coding sta davvero lavorando. Gli agenti noti (claude, cursor, codex, gemini, pi e altri) vengono valutati dall'attività dei loro stessi processi, e quel lato non richiede alcuna configurazione nell'agente. Collega Claude Code, Cursor, Codex o Antigravity sotto la condizione Agente IA quando vuoi lo stato esatto della sessione, inclusi gli agenti integrati nelle app Cursor e Antigravity, che non hanno un proprio processo da osservare. Vengono proposti solo gli strumenti effettivamente installati sul tuo Mac, e Keepresso ricontrolla ogni collegamento nel tempo, riparando un hook che è sparito o non è più aggiornato.

Ma il rilevamento può coprire solo gli agenti che Keepresso sa riconoscere, e ne compaiono di nuovi ogni settimana. Un lease inverte la direzione: invece di far indovinare Keepresso, è l'agente stesso a dire a Keepresso quando ha bisogno del Mac sveglio, per cosa e per quanto tempo, poi continua a dimostrare di essere ancora vivo. Qualsiasi strumento in grado di eseguire un comando o chiamare un server MCP può farlo, comunque si chiami e comunque funzioni al suo interno. I due si combinano bene: il rilevamento copre le sessioni di tutti i giorni a cui non hai pensato, i lease coprono i lavori lunghi deliberati e tutto ciò che il rilevamento non può vedere.

Perché un lease invece di keepresso start

keepresso start è un ottimo interruttore manuale, ma l'automazione vuole garanzie diverse:

• A durata limitata. Un lease ha un TTL che il proprietario deve continuare a rinnovare, e una durata massima (limitata a 7 giorni) che gli heartbeat non possono mai estendere. Un lavoro fuori controllo non può tenere sveglio il Mac oltre il suo tetto.
• Auto-riparante. Nessun heartbeat, nessun mantenimento. Il lease di uno script andato in crash scade da solo.
• Condiviso in modo pulito. Più strumenti possono detenere lease contemporaneamente. Keepresso li unisce e lascia dormire il Mac dopo che l'ultimo è terminato, eseguendo la tua azione di fine sessione a quel punto, non prima.
• Visibile. Ogni lease attivo compare nel menu con il suo conto alla rovescia, con il nome dello strumento e dell'attività che lo ha preso.

Il ciclo di vita di un lease

Acquisisci un lease quando il lavoro inizia. Scegli tu l'id (un UUID), dai un nome allo strumento e all'attività, e imposti il TTL in secondi:

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

Invia un heartbeat prima che sia trascorsa metà del TTL, in un ciclo per tutto il tempo in cui il lavoro è in corso. Un heartbeat può anche modificare il TTL:

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

Rilascia quando il lavoro è finito, così il Mac non deve aspettare il resto del TTL:

keepresso lease release --id "$ID"

Ed elenca ciò che è attivo, i tuoi e quelli di tutti gli altri:

keepresso lease list --json

Ogni comando accetta --json per un output leggibile dalle macchine, e i codici di uscita sono pensati per gli script: 0 ok, 2 l'app non è in esecuzione, 3 il lease non è stato trovato o è già terminato, 4 i lease sono disattivati nelle Preferenze.

I lease sono governati da un interruttore in Preferenze, Automazione, attivo per impostazione predefinita. Disattivalo e ogni acquisizione viene rifiutata con codice di uscita 4, così l'automazione non può mai scavalcare la tua scelta.

Vedili e fermali dal menu

I lease attivi compaiono nella scheda di stato del pannello del menu, ciascuno con un conto alla rovescia. Resti tu al comando: Stop li termina tutti in una volta, e il Mac è libero di tornare a dormire.

Insegna al tuo agente in un clic

Non devi spiegare nulla di tutto questo al tuo agente a mano. Il pacchetto dell'app include una skill keep-awake pronta all'uso che insegna a un agente l'intero protocollo, sia la riga di comando keepresso sia il server MCP, oltre a quando usarlo: prima di una build lunga, un render, un download o un'esecuzione notturna. In Preferenze, Automazione, installala direttamente da disco nella cartella delle skill del tuo agente. Per gli agenti che non ne hanno una, Keepresso copia invece la skill completa come istruzioni pronte da incollare: incollale nell'agente una volta e il protocollo è appreso, oppure salvale in un file di configurazione globale che il tuo agente legge sempre, come CLAUDE.md o AGENTS.md, così ogni sessione futura sa già come e quando tenere sveglio il Mac. La skill si trova anche nel pacchetto in Keepresso.app/Contents/Resources/AgentSkill/keep-awake se preferisci collegarla da solo.

Il server MCP

Per gli agenti che parlano il Model Context Protocol, il pacchetto include keepresso-mcp:

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

Espone strumenti per acquisire, inviare heartbeat, rilasciare ed elencare i lease, leggere lo stato di Keepresso e leggere la programmazione di risveglio del sistema. MCP è un protocollo aperto, quindi non è limitato agli agenti di coding: qualsiasi app compatibile con MCP può detenere il proprio lease e tenere in vita il Mac mentre lavora. Preferenze, Automazione contiene frammenti di configurazione pronti da copiare per Claude Code, Gemini CLI, Grok e Codex. Per Claude Code si riduce a un solo comando:

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

Programmazioni di risveglio per l'automazione, facoltative

L'automazione può anche leggere quando è programmato il prossimo risveglio del sistema e, se lo consenti, modificare quella programmazione:

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

La lettura è sempre consentita. La modifica della programmazione funziona solo mentre Consenti all'automazione di modificare la programmazione di risveglio è attivo in Preferenze, Automazione. È disattivata per impostazione predefinita, perché un risveglio programmato è una modifica a livello di sistema applicata dall'helper amministratore. Il server MCP porta gli strumenti corrispondenti sotto la stessa regola.

Sveglia il Mac per le esecuzioni IA programmate

I lease e il CLI coprono il lavoro già in corso. Ma alcuni lavori degli agenti sono programmati per più tardi: una routine di Claude Desktop impostata per le 3 del mattino, un'automazione Codex con cadenza notturna. Se nel frattempo il Mac si è addormentato, l'esecuzione viene semplicemente saltata.

Esecuzioni IA programmate colma questa lacuna senza alcuno script. Attivalo in Preferenze, Automazione, Esecuzioni IA programmate, poi attiva ogni strumento per cui vuoi che il Mac si svegli. Keepresso legge le attività ricorrenti che quello strumento ha programmato, sveglia il Mac qualche minuto prima di ciascuna e lo mantiene sveglio per una breve finestra così l'esecuzione avviene anche a coperchio chiuso.

Niente viene importato finché non attivi uno strumento, e ogni routine mantiene il proprio interruttore, così puoi svegliarti per il report notturno e ignorare il resto. Se l'elenco risulta vuoto, lo strumento non ha ancora un'attività ricorrente locale.

• Attivi per singolo strumento. Claude Desktop e Codex partono entrambi disattivati, così non ci si sveglia mai per qualcosa che non usi. Legge solo la programmazione e il nome dell'attività, mai il suo prompt.
• Solo programmazioni locali. Le routine cloud girano sui server del fornitore, che il tuo Mac sia sveglio o no, quindi vengono ignorate. Questo è per le esecuzioni che hanno bisogno che sia il tuo Mac ad essere acceso.
• Per un'esecuzione più lunga, abbinala a un lease: la finestra di risveglio avvia l'esecuzione, e l'agente mantiene un lease per tenere sveglio il Mac finché il lavoro non è davvero terminato.

Dietro le quinte usa lo stesso meccanismo di risveglio programmato dei comandi keepresso wake del CLI qui sopra, quindi richiede l'helper amministratore ed è affidabile a corrente (a batteria il firmware può saltare il risveglio).

Cosa ti serve

• Keepresso 1.17 o successiva per i lease, il server MCP e i comandi di risveglio del CLI; 1.18 o successiva per le Esecuzioni IA programmate. Passaggi di installazione: primi passi.
• Per il CLI su un'installazione DMG, collega il comando una volta.
• Per le modifiche alla programmazione di risveglio e per le Esecuzioni IA programmate, l'helper amministratore e gli interruttori facoltativi qui sopra.

Correlati

• Mantieni sveglio il Mac da riga di comando copre il resto del CLI keepresso.
• Mantieni sveglio il Mac durante le build lunghe mostra gli approcci basati sui trigger per i lavori che esegui tu stesso.
• Fai girare agenti su un Mac sempre acceso? MyAgens gli dà una squadra di agenti Claude Code che comandi da Telegram.