KI-Agenten und Skripte deinen Mac wach halten lassen mit Automatisierungs-Leases

Ein Agent, der über Nacht einen langen Job fährt, braucht den Mac wach, solange er arbeitet, und schlafend, sobald er fertig ist. Ein schlichtes „wach halten an“ schafft die erste Hälfte und scheitert an der zweiten: Stürzt das Tool ab oder vergisst es, wieder auszuschalten, bleibt der Mac für immer wach gepinnt. Automatisierungs-Leases beheben das. Ein Skript oder ein KI-Agent erwirbt eine Lease mit Zeitlimit, erneuert sie, während die Arbeit läuft, und gibt sie am Ende frei. Stirbt das Tool mitten im Job, läuft die Lease einfach aus und der Mac darf wieder schlafen. Nichts hält die Maschine aus Versehen weiter wach.

Keepresso liefert den ganzen Stack dafür: die keepresso lease-Befehle, einen MCP-Server, den jeder MCP-fähige Agent aufrufen kann, und einen mitgelieferten Agenten-Skill, den du mit einem Klick installierst.

Erkennung beobachtet, eine Lease spricht

Keepresso hat bereits einen KI-Agent-Trigger, der erkennt, wann ein Coding-Agent wirklich arbeitet: Claude Code kann seinen echten Status über einen optionalen Hook melden, und die bekannten Agenten (claude, codex, gemini und Freunde) werden an der Aktivität ihrer eigenen Prozesse gemessen. Diese Seite braucht im Agenten gar keine Einrichtung, Keepresso beobachtet einfach.

Doch Erkennung kann nur die Agenten abdecken, die Keepresso zu erkennen weiß, und neue tauchen jede Woche auf. Eine Lease dreht die Richtung um: Statt dass Keepresso rät, sagt der Agent selbst Keepresso, wann er den Mac wach braucht, wofür und wie lange, und beweist dann laufend, dass er noch lebt. Jedes Tool, das einen Befehl ausführen oder einen MCP-Server aufrufen kann, schafft das, wie auch immer es heißt und wie auch immer es innen funktioniert. Beide ergänzen sich gut: Erkennung deckt die alltäglichen Sitzungen ab, an die du nicht gedacht hast, Leases decken die bewussten langen Jobs ab und alles, was Erkennung nicht sehen kann.

Warum eine Lease statt keepresso start

keepresso start ist ein feiner manueller Schalter, aber Automatisierung will andere Garantien:

• Begrenzt. Eine Lease hat eine TTL, die der Besitzer immer wieder erneuern muss, und eine maximale Lebensdauer (auf 7 Tage gedeckelt), die Heartbeats niemals verlängern können. Ein durchgehender Job kann den Mac nicht über seine Obergrenze hinaus wach halten.
• Selbstheilend. Kein Heartbeat, kein Hold. Die Lease eines abgestürzten Skripts läuft von selbst aus.
• Sauber geteilt. Mehrere Tools können gleichzeitig Leases halten. Keepresso vereint sie und lässt den Mac schlafen, sobald die letzte endet, und führt deine Aktion zum Sitzungsende dann aus, nicht früher.
• Sichtbar. Jede aktive Lease erscheint im Menü mit ihrem Countdown, benannt nach dem Tool und der Aufgabe, die sie genommen hat.

Der Lebenszyklus einer Lease

Erwirb eine Lease, wenn der Job startet. Du wählst die id (eine UUID), benennst das Tool und die Aufgabe und setzt die TTL in Sekunden:

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

Sende einen Heartbeat, bevor die Hälfte der TTL verstrichen ist, in einer Schleife, solange die Arbeit läuft. Ein Heartbeat kann auch die TTL anpassen:

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

Gib sie frei, wenn der Job fertig ist, damit der Mac nicht den Rest der TTL abwartet:

keepresso lease release --id "$ID"

Und liste auf, was aktiv ist, deins und das aller anderen:

keepresso lease list --json

Jeder Befehl nimmt --json für maschinenlesbare Ausgabe, und die Exit-Codes sind für Skripte gemacht: 0 ok, 2 die App läuft nicht, 3 die Lease wurde nicht gefunden oder ist schon beendet, 4 Leases sind in den Einstellungen ausgeschaltet.

Leases werden von einem Schalter unter Einstellungen, Automatisierung gesteuert, standardmäßig an. Schalte ihn aus, und jedes acquire wird mit Exit-Code 4 abgelehnt, sodass Automatisierung deine Entscheidung nie überstimmen kann.

Sie im Menü sehen und stoppen

Aktive Leases erscheinen in der Statuskarte des Menü-Panels mit je einem Countdown. Du behältst die Kontrolle: Stopp beendet sie alle auf einmal, und der Mac darf wieder schlafen.

Bring es deinem Agenten mit einem Klick bei

Du musst deinem Agenten nichts davon von Hand erklären. Das App-Bundle liefert einen fertigen Keep-Awake-Skill, der einem Agenten das gesamte Protokoll beibringt, sowohl die keepresso-Kommandozeile als auch den MCP-Server, dazu wann er es einsetzen soll: vor einem langen Build, Renderjob, Download oder nächtlichen Lauf. Installiere ihn unter Einstellungen, Automatisierung direkt von der Festplatte in den Skills-Ordner deines Agenten. Für Agenten ohne einen solchen kopiert Keepresso stattdessen den vollständigen Skill als einfügefertige Anweisungen: Füg sie einmal in den Agenten ein, und das Protokoll ist gelernt, oder speichere sie in einer globalen Konfigurationsdatei, die dein Agent immer liest, etwa CLAUDE.md oder AGENTS.md, sodass jede künftige Sitzung schon weiß, wie und wann sie den Mac wach hält. Der Skill liegt außerdem im Bundle unter Keepresso.app/Contents/Resources/AgentSkill/keep-awake, falls du ihn lieber selbst verdrahtest.

Der MCP-Server

Für Agenten, die das Model Context Protocol sprechen, liefert das Bundle keepresso-mcp:

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

Er stellt Tools bereit, um Leases zu erwerben, per Heartbeat zu erneuern, freizugeben und aufzulisten, Keepressos Status auszulesen und den System-Aufweckplan zu lesen. MCP ist ein offenes Protokoll, das ist also nicht auf Coding-Agenten beschränkt: Jede MCP-fähige App kann ihre eigene Lease halten und den Mac am Leben halten, während sie arbeitet. Einstellungen, Automatisierung hat Einrichtungs-Snippets zum Kopieren bereit für Claude Code, Gemini CLI, Grok und Codex. Für Claude Code läuft es auf einen Befehl hinaus:

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

Aufweckpläne für Automatisierung, optional

Automatisierung kann auch lesen, wann das System als Nächstes aufwachen soll, und, wenn du es erlaubst, diesen Plan ändern:

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

Lesen ist immer erlaubt. Den Plan ändern geht nur, solange Automatisierung darf den Aufweckplan ändern unter Einstellungen, Automatisierung an ist. Es ist standardmäßig aus, weil ein geplanter Aufweck eine systemweite Änderung ist, die der Administrator-Helper anwendet. Der MCP-Server trägt die passenden Tools unter derselben Regel.

Was du brauchst

• Keepresso 1.17 oder neuer. Installationsschritte: Erste Schritte.
• Für die CLI bei einer DMG-Installation: den Befehl einmal verlinken.
• Für Änderungen am Aufweckplan den Administrator-Helper und den optionalen Schalter oben.

Verwandte Themen

• Halte deinen Mac von der Kommandozeile aus wach behandelt den Rest der keepresso-CLI.
• Halte deinen Mac bei langen Builds wach zeigt die trigger-basierten Ansätze für Jobs, die du selbst startest.
• Laufen auf einem Mac im Dauerbetrieb schon Agenten? MyAgens gibt ihm eine Crew von Claude Code Agenten, die du von Telegram aus steuerst.