promptgarten 🌱
🌍 EN

Befehls-Referenz · Cursor CLI

agent [prompt...]

Startet die Cursor CLI im Standard-Agent-Modus, optional direkt mit einem Prompt als Argument.

agent ohne weiteren Unterbefehl startet die interaktive Session im Agent-Modus – dem Standardmodus mit vollem Werkzeugzugriff (Lesen, Schreiben, Shell-Befehle, Web). Ein optionales Prompt-Argument wird direkt als erste Nachricht gesendet, z.B. agent "refactor the auth module to use JWT tokens". Ohne Argument öffnet sich ein leeres Chat-Fenster. Für nicht-interaktive Läufe (Skripte, CI) sorgt zusätzlich das Flag -p/--print dafür, dass nur die finale Antwort ausgegeben wird.

✅ WANN EINSETZEN?

Direkt mit einer konkreten Aufgabe starten, ohne erst zu tippen

agent "fix the failing tests in src/auth"

Interaktive Session für explorative Arbeit ohne festen Auftrag starten

agent — dann im Chat Schritt für Schritt Ziele und Rückfragen klären

⛔ WANN EHER NICHT?

Lauf soll unbeaufsichtigt in einem Skript oder CI-Job laufen

Der Standard-Agent-Modus fragt vor Befehlen interaktiv nach Freigabe und blockiert damit unattended Läufe.

Besser: -p und --force kombinieren, z.B. agent -p --force "<prompt>" (siehe Sammel-Eintrag Global Options)

Nur lesen/analysieren, keine Datei-Änderungen gewünscht

Der Standardmodus hat vollen Schreib- und Shell-Zugriff.

Besser: --mode ask beim Start setzen bzw. /ask nach dem Start verwenden

QUELLEN