Référence des commandes · Cursor CLI
agent worker start
Démarre le worker privé et le connecte à Cursor.
agent worker start démarre le processus worker privé et le connecte à Cursor, afin que les tâches de cloud agent tournent dans son propre environnement plutôt que dans le cloud de Cursor. Il se configure via des flags comme --worker-dir (racine du workspace, répétable, la première valeur détermine l'identité d'assignation), --name, --label/--labels-file, --pool/--pool-name, --idle-release-timeout et --management-addr pour /healthz, /readyz, /metrics. --verbose active des logs de démarrage détaillés.
✅ QUAND L’UTILISER ?
Exposer plusieurs dépôts à la fois comme workspaces de worker
agent worker start --worker-dir ~/repos/app-a --worker-dir ~/repos/app-b
Exposer des endpoints health/metrics pour surveiller le worker
agent worker start --management-addr 0.0.0.0:9100
⛔ QUAND ÉVITER ?
On veut vérifier au préalable si l'auth et le réseau fonctionneraient déjà
agent worker start se connecte immédiatement en production, sans vérification préalable
Mieux: exécuter d'abord agent worker debug, puis agent worker start
Seule une exécution d'agent unique et courte est nécessaire
agent worker start démarre un processus durable connecté à Cursor
Mieux: utiliser une session normale avec agent ou agent -p plutôt que de faire tourner un worker
SOURCES
- Cursor Docs — CLI Reference: Parameters ↗ cursor.com