Prompting

Eine klare Absichtserklärung wird für die besten Ergebnisse empfohlen. Du kannst zum Beispiel den Prompt „schreibe keinen Code” verwenden, um sicherzustellen, dass der Agent keine Dateien bearbeitet. Das ist generell hilfreich, wenn du Aufgaben planst, bevor du sie implementierst. Der Agent verfügt derzeit über Tools für Dateioperationen, die Suche und das Ausführen von Shell-Befehlen. Weitere Tools werden hinzugefügt, ähnlich wie beim IDE-Agent.

MCP

Agent unterstützt MCP (Model Context Protocol) für erweiterte Funktionalität und Integrationen. Die CLI erkennt automatisch deine mcp.json-Konfigurationsdatei und berücksichtigt sie, wodurch dieselben MCP-Server und Tools aktiviert werden, die du für die IDE konfiguriert hast.

Regeln

Der CLI-Agent unterstützt das gleiche Regelsystem wie die IDE. Du kannst Regeln im .cursor/rules-Verzeichnis erstellen, um dem Agent Kontext und Anweisungen zu geben. Diese Regeln werden automatisch geladen und basierend auf ihrer Konfiguration angewendet, sodass du das Verhalten des Agents für verschiedene Teile deines Projekts oder bestimmte Dateitypen anpassen kannst.
Die CLI liest auch AGENT.md und CLAUDE.md im Projektverzeichnis (falls vorhanden) und wendet sie als Regeln zusätzlich zu .cursor/rules an.

Arbeiten mit Agent

Frühere Nachrichten kannst du mit Pfeil hoch (Arrow-Up) aufrufen und durch sie durchgehen.

Review

Überprüfe Änderungen mit Ctrl+R. Drück I, um Folgeanweisungen hinzuzufügen. Verwende Arrow-Up/Arrow-Down zum Scrollen und Arrow-Left/Arrow-Right zum Wechseln zwischen Dateien.

Kontext auswählen

Wähle Dateien und Ordner aus, die mit @ in den Kontext aufgenommen werden sollen. Mach Platz im Kontextfenster, indem du /compress ausführst. Details findest du unter Summarization.

Verlauf

Mach mit einem bestehenden Thread mit --resume [thread id] weiter, um den vorherigen Kontext zu laden. Um das jüngste Gespräch fortzusetzen, benutze cursor-agent resume. Du kannst auch cursor-agent ls ausführen, um eine Liste früherer Gespräche zu sehen.

Befehlsbestätigung

Bevor Terminal-Befehle ausgeführt werden, fragt dich die CLI, ob du die Ausführung genehmigen (Y) oder ablehnen (N) möchtest.

Nicht-interaktiver Modus

Verwende -p oder --print, um den Agent im nicht-interaktiven Modus auszuführen. Dies gibt die Antwort in der Konsole aus. Mit dem nicht-interaktiven Modus kannst du den Agent nicht-interaktiv aufrufen. Das ermöglicht es dir, ihn in Skripte, CI-Pipelines usw. zu integrieren. Du kannst dies mit --output-format kombinieren, um zu steuern, wie die Ausgabe formatiert wird. Verwende zum Beispiel --output-format json für strukturierte Ausgabe, die in Skripten einfacher zu parsen ist, oder --output-format text für reine Textausgabe.
Cursor hat im nicht-interaktiven Modus vollständigen Schreibzugriff.