promptgarten 🌱
🌍 EN

Befehls-Referenz · Cursor CLI

agent worker

Übergeordneter Befehl zum Starten eines privaten Cloud-Workers, der Agent-Läufe in der eigenen Umgebung ausführt.

agent worker verbindet die eigene Maschine mit Cursor und lässt Cloud-Agent-Aufgaben dort statt in Cursors eigener Cloud-Umgebung laufen (self-hosted). Enthält die Unterbefehle start und debug. Konfiguriert wird der Worker über Flags wie --worker-dir, --name, --label bzw. --labels-file, --pool bzw. --pool-name und --idle-release-timeout.

✅ WANN EINSETZEN?

Eigene Hardware bzw. Umgebung für Cloud-Agent-Läufe bereitstellen (Datenschutz, spezielle Tools)

agent worker start --name build-worker-1 --worker-dir ~/repos/myapp

Mehrere Worker als Pool registrieren, aus dem Cloud-Agents sich bedienen

agent worker start --pool --pool-name ci-pool

⛔ WANN EHER NICHT?

Nur ein einzelner lokaler Agent-Lauf ist nötig

agent worker startet einen dauerhaft laufenden, mit Cursor verbundenen Prozess für Cloud-Agent-Handoffs, keinen einmaligen Lauf.

Besser: Normale interaktive Session mit agent bzw. agent -p nutzen

Konfiguration bzw. Verbindung soll vor dem eigentlichen Start geprüft werden

agent worker start verbindet sofort; Probleme mit Auth, Privacy oder Routing werden erst danach sichtbar.

Besser: Vorher agent worker debug laufen lassen, um Preflight-Diagnosen zu sehen

QUELLEN