Agent in der CLI verwenden

Modi

Die CLI unterstützt dieselben Modi wie der Editor. Wechseln Sie den Modus mit Slash-Befehlen oder dem Flag --mode.

Plan-Modus

Nutze den Plan-Modus, um dein Vorgehen vor dem Programmieren zu planen. Der Agent stellt Rückfragen, um deinen Plan zu verfeinern.

• Drücke Shift+Tab, um zum Plan-Modus zu wechseln
• Nutze /plan, um in den Plan-Modus zu wechseln
• Starte mit dem Flag --plan oder --mode=plan

Ask-Modus

Nutze den Ask-Modus, um Code zu erkunden, ohne Änderungen vorzunehmen. Der Agent durchsucht deine Codebasis und beantwortet Fragen, ohne Dateien zu bearbeiten.

• Nutze /ask, um in den Ask-Modus zu wechseln
• Starte mit dem Flag --mode=ask

Prompting

Für optimale Ergebnisse solltest du deine Absicht klar formulieren. Du kannst beispielsweise den Prompt „do not write any code“ verwenden, um sicherzustellen, dass der Agent keine Dateien bearbeitet. Das ist besonders hilfreich, wenn du Aufgaben planst, bevor du sie umsetzt.

Der Agent verfügt über Tools für Dateioperationen, Suche, das Ausführen von Shell-Befehlen und Webzugriff.

MCP

Agent unterstützt MCP (Model Context Protocol) für erweiterte Funktionen und Integrationen. Die CLI erkennt deine Konfigurationsdatei mcp.json automatisch und berücksichtigt sie, sodass dieselben MCP-Server und Tools verfügbar sind, die du für den Editor konfiguriert hast.

ACP

Agent unterstützt auch ACP (Agent Client Protocol) für Integrationen mit benutzerdefinierten Clients. Verwenden Sie agent acp, um die Cursor-CLI als ACP-Server über stdio mit JSON-RPC-Nachrichten zu starten.

Regeln

Der CLI-Agent unterstützt dasselbe Regelsystem wie der Editor. Du kannst im Verzeichnis .cursor/rules Regeln erstellen, um dem Agenten Kontext und Anweisungen bereitzustellen. Diese Regeln werden anhand ihrer Konfiguration automatisch geladen und angewendet. So kannst du das Verhalten des Agenten für verschiedene Teile deines Projekts oder bestimmte Dateitypen anpassen.

Mit dem Agenten arbeiten

Navigation

Mit der Pfeiltaste nach oben (ArrowUpArrow Up) kannst du auf vorherige Nachrichten zugreifen und sie durchblättern.

Tastenkombinationen für die Eingabe

• Shift+Tab — Zwischen den Modi wechseln (Agent, Plan, Ask)
• Shift+Enter — Einen Zeilenumbruch statt einer Eingabe einfügen, um mehrzeilige Prompts einfacher zu schreiben.
• Ctrl+D — Die CLI beenden. Entspricht dem Standardverhalten der Shell und erfordert zum Beenden zweimaliges Drücken.
• Ctrl+J oder +Enter — Universelle Alternativen zum Einfügen von Zeilenumbrüchen, die in allen Terminals funktionieren.

Überprüfen

Überprüfen Sie Änderungen mit Ctrl+R. Drücken Sie i, um Folgeanweisungen hinzuzufügen. Mit ArrowUpArrow Up/ArrowDownArrow Down scrollen Sie, mit ArrowLeftArrow Left/ArrowRightArrow Right wechseln Sie zwischen Dateien.

Kontext auswählen

Wähle mit @ Dateien und Ordner aus, die in den Kontext aufgenommen werden sollen. Führe /summarize aus, um Platz im Kontextfenster zu schaffen. /compress bleibt ein Alias.

Übergabe an Cloud-Agent

Übertrage deine Unterhaltung an einen Cloud-Agent, damit er weiterarbeiten kann, während du nicht da bist. Stelle jeder Nachricht ein & voran, um sie an die Cloud zu senden. Setze die Unterhaltung im Web oder auf Mobilgeräten unter cursor.com/agents fort.

# Sende dem Cloud-Agent mitten in der Unterhaltung eine Aufgabe& refactor the auth module and add comprehensive tests

CLI-Worktrees

Übergebe -w oder --worktree [name], um den Agent in einem neuen Git-Worktree auszuführen, anstatt deinen aktuellen Checkout direkt zu bearbeiten. Cursor erstellt diese Checkouts unter ~/.cursor/worktrees/<reponame>/<name>, neben den im Editor erstellten Worktrees. Wenn du name weglässt, generiert Cursor einen Namen.

Cursor bereinigt CLI-Worktrees nach denselben Aufbewahrungsregeln wie Editor-Worktrees. Informationen zu Bereinigungseinstellungen und Limits findest du unter Wie werden alte Worktrees bereinigt?.

Kombiniere --workspace <path> mit --worktree, wenn du ein explizites Repository-Stammverzeichnis benötigst. Andernfalls verwendet die CLI das aktuelle Arbeitsverzeichnis. --worktree ändert nur, wo der Agent innerhalb dieses Projekts Dateien bearbeitet.

# Erstellen Sie einen temporären Worktree aus dem aktuellen Repository mit generiertem Namenagent --worktree "upgrade the test runner and fix any broken snapshots"# Erstellen Sie einen benannten Worktree aus einem anderen Repositoryagent --workspace ~/src/my-app --worktree auth-fix "fix the flaky auth test and open a PR"

Verlauf

Setze mit --resume [thread id] einen bestehenden Thread fort, um den vorherigen Kontext zu laden.

Um die zuletzt verwendete Unterhaltung fortzusetzen, verwende agent resume, --continue oder den Slash-Befehl /resume.

Du kannst auch agent ls ausführen, um frühere Chats zu öffnen und einen davon fortzusetzen.

Befehlsfreigabe

Bevor die CLI Terminalbefehle ausführt, wirst du aufgefordert, die Ausführung zu genehmigen (y) oder abzulehnen (n).

Nicht-interaktiver Modus

Verwende -p oder --print, um Agent im nicht-interaktiven Modus auszuführen. Die Antwort wird dann in der Konsole ausgegeben.

Im nicht-interaktiven Modus kannst du Agent ohne Interaktion aufrufen. So kannst du ihn in Skripte, CI-Pipelines usw. integrieren.

Du kannst dies mit --output-format kombinieren, um zu steuern, wie die Ausgabe formatiert wird. Verwende beispielsweise --output-format json für strukturierte Ausgaben, die sich leichter in Skripten verarbeiten lassen, oder --output-format text für die Klartextausgabe der endgültigen Antwort des Agent.