promptgarten 🌱
🌍 EN

Befehls-Referenz · Cursor CLI

agent worker start

Startet den privaten Cloud-Worker und verbindet ihn mit Cursor.

agent worker start startet den privaten Worker-Prozess und verbindet ihn mit Cursor, sodass Cloud-Agent-Aufgaben in der eigenen Umgebung statt in Cursors Cloud laufen. Konfiguriert wird er über Flags wie --worker-dir (Workspace-Root, wiederholbar, erster Wert bestimmt die Assignment-Identität), --name, --label/--labels-file, --pool/--pool-name, --idle-release-timeout und --management-addr für /healthz, /readyz, /metrics. --verbose aktiviert ausführliche Start-Logs.

✅ WANN EINSETZEN?

Mehrere Repos gleichzeitig als Worker-Workspace bereitstellen

agent worker start --worker-dir ~/repos/app-a --worker-dir ~/repos/app-b

Health- und Metrics-Endpunkte für Monitoring des Workers exponieren

agent worker start --management-addr 0.0.0.0:9100

⛔ WANN EHER NICHT?

Vorab prüfen, ob Auth und Netzwerk überhaupt funktionieren würden

agent worker start verbindet sofort produktiv, ohne vorab nur zu testen.

Besser: Erst agent worker debug ausführen, danach agent worker start

Nur ein einzelner, kurzer Agent-Lauf ist nötig

agent worker start startet einen dauerhaft laufenden, mit Cursor verbundenen Prozess.

Besser: Normale Session mit agent bzw. agent -p nutzen statt einen Worker zu betreiben

QUELLEN