Cursor Agent-Modus nutzen: Repo-Aufgabe starten und Diffs prüfen

Agent öffnen, eine begrenzte Repo-Aufgabe geben, Diffs selbst lesen, bevor etwas bleibt.

Das Repo ist in Cursor schon offen. Das Modell soll arbeiten — ohne einen Stapel ungelesener Diffs zu übernehmen. Die offizielle Hilfe nennt diesen Weg den Agent-Modus: einen Chat starten, eine Repo-Aufgabe geben, jede berührte Datei lesen.

Die suchbare Aufgabe ist Cursor Agent-Modus nutzen: das Agent-Panel öffnen, den nur lesenden Ask meiden, eine begrenzte Aufgabe schreiben und in der Diff-Ansicht entscheiden, was bleibt. Kürzel und Prüfschritte folgen cursor.com/help/ai-features/agent.

⌘IMac öffnet Agent; Windows/Linux: Ctrl+I
4Modi: Agent, Ask, Plan, Debug
1Eine Repo-Aufgabe pro neuem Chat

Den Modus wählen, der Dateien ändern darf

Agent schreibt

Er sucht den Baum, ändert viele Dateien, startet eine Shell und kann bei Fehlern anhalten. Das Ergebnis ist ein Patch, den ihr lest und behaltet.

Ask liest nur

Ask beantwortet Fragen und ändert nichts. Sitzt das Panel auf Ask, gibt es eine Erklärung und eine leere Diff. Umschalt+Tab wechselt die Modi; das Dropdown tut dasselbe.

ModusWannÄndert Dateien?
AgentFunktion, Refactor oder Fix, den ihr prüfen wolltJa
AskNur den Baum verstehenNein
PlanGroße Änderung über viele Dateien, zuerst ein PlanNach Freigabe des Plans
DebugFehler, der Laufzeitbelege brauchtJa

Ein Durchlauf: starten, zuweisen, prüfen

  1. 01
    Das Agent-Panel öffnen

    In einem Ordner, der schon ein Git-Repo ist, Cmd+I (Mac) oder Ctrl+I (Windows/Linux). Der Schalter muss Agent heißen. War der letzte Thread eine andere Sache, neuen Chat öffnen. Offiziell: jeder Modus hat eigenen Kontext; bei Aufgabenwechsel ist frisch sauberer.

  2. 02
    Eine begrenzte Repo-Aufgabe geben

    Ergebnis, Dateien oder Bereich und das Fertig-Kriterium nennen. Beispiel: Nullprüfung in src/auth/session.ts, vorhandenen Unit-Test laufen. Keine fünf fremden Arbeiten. Das offizielle Beispiel ist eine konkrete Bitte.

  3. 03
    Die Diff-Ansicht beobachten

    Return. Agent sucht, wendet Änderungen während der Arbeit an. Dateien öffnen sich in der Diff. Stop, wenn er den genannten Ordner verlässt. Eine Folgeanweisung wartet in der Queue, bis der Lauf endet.

  4. 04
    Lesen, dann behalten oder ablehnen

    Neue und gelöschte Zeilen lesen. Unerwünschte Brocken ablehnen. Über eine frühere Nachricht Restore Checkpoint: Dateiänderungen danach gehen zurück, der Chat bleibt. Tests selbst laufen lassen; eine grüne Zeile im Agent-Log ist keine Abnahme.

In src/auth/session.ts eine Wache: fehlt die
user id, 401 zurück. Den Ordner billing nicht
anfassen. Den vorhandenen session-Unit-Test
laufen und bei Fehler stoppen.

Wo erste Aufgaben oft brechen

Das Panel stand auf Ask
Keine Datei ändert sich. Mit Umschalt+Tab oder dem Moduswähler auf Agent, dieselbe Eingabe erneut senden.
Der Prompt nannte keine Grenze
Agent sucht weit. Verzeichnis, Test und verbotene Pfade nennen.
Den ganzen Stapel übernommen
Fremde Dateien ablehnen. Löschungen prüfen. Ist die Form falsch, Checkpoint wiederherstellen statt eine zweite Umschreibung auf einen schlechten Patch zu legen.

Eine Aufgabe, ein Chat, dann die Diff lesen. Die Übernehmen-Taste ist keine Prüfung.

Cloud Agents sind eine andere Tür

cursor.com/agents kann einen Cloud Agent im Browser starten. Die Desktop-Schleife dieses Leitfadens gilt weiter: die Prüfung gehört euch. Ungelesene Diffs auf keinem der Wege mergen.

Müssen zwei Leute eine Umstrukturierung abstimmen, bevor jemand ausliefert, Liste und riskante Brocken auf eine Seite. Ein kurzer oakmeet-Raum reicht — Browser, Raumcode, kein Konto. Grenzen stehen unter acht Personen, etwa eine Stunde.

Ist Agent dasselbe wie Composer oder Chat?

Die aktuelle Hilfe nennt Agent den Assistenten, der Dateien ändern und Befehle ausführen kann. Ältere Oberflächen schrieben Composer. Zeigt euer Build noch Composer, den Modus wählen, der Dateien ändern darf — nicht den nur lesenden Ask/Chat.

Brauche ich Konto und bezahlten Tarif?

Anmeldung ist nötig. Der Verbrauch folgt Cursor-Tarif und Modellkontingent. Aktuelle Tarife stehen unter cursor.com/docs. Diese Seite verkauft keinen Tarif.

Kann ich nach dem Übernehmen zurück?

Restore Checkpoint an einer früheren Agent-Nachricht setzt Dateiänderungen danach zurück. git checkout / git restore gelten weiter für alles auf der Platte. Restore löscht den Chat nicht.

Lieber zuerst Plan?

Bei einer großen Änderung über viele Dateien sagt die Tabelle: zuerst Plan, Ansatz freigeben, dann darf er ändern. Für eine einzelne, klar begrenzte Repo-Aufgabe geht dieses Tutorial den Agent-Weg.

Raum starten