Cursor

Der Cursor-Provider führt Cursors Agent auf dem Rechner des Relays aus, über das Cursor Agent SDK. OAR startet einen Worker-Prozess pro Konversation. Der Agent arbeitet im Arbeitsordner der Konversation, mit den Modellen deines Cursor-Kontos. Anders als Claude verwendet er keine Anmeldung auf dem Rechner: Du gibst OAR einen Cursor-API-Key.

Diese Seite behandelt, was bei Cursor besonders ist. Der Chat, die Queue und der Dateibrowser funktionieren wie bei jedem Provider; unter Provider im Überblick steht, wie Cursor im Vergleich abschneidet.

Was du brauchst #

• Einen Cursor-API-Key. Du fügst ihn einmal in OAR ein; siehe Einschalten.
• Nichts zu installieren. Cursor braucht keine CLI und keine Cursor-App auf dem Rechner, daher hat der Unter-Tab Cursor keine CLI-Zeile.

Wo was liegt:

Standardmäßig liegen die Zustandsordner unter cursor-agents im Datenordner des Relays: ~/.oar/data/cursor-agents (%APPDATA%\oar\data\cursor-agents unter Windows) bei einer globalen Installation, server/data/cursor-agents in einem Git-Checkout. Neu in 0.9.14 Vor 0.9.14 hielt eine globale Installation sie im Paketordner, den ein Update ersetzt, sodass eine Konversation ihren Agent verlieren konnte; eine Konversation, deren Ordner noch da ist, verwendet ihn weiter. CURSOR_AGENT_STORE_DIR verschiebt sie; siehe Umgebungsvariablen.

Einschalten #

Öffne Settings → Providers → Cursor (Einstellungen → Provider → Cursor). Das Panel trägt die Überschrift Cursor SDK.

Die Statuszeile unter den Feldern sagt, wo du stehst:

Was das Speichern bewirkt:

• Modellerkennung. Wenn Cursor eingeschaltet ist und du einen neuen Key speicherst, das Modell änderst oder Cursor wieder einschaltest, fragt OAR Cursor nach den Modellen, die dein Key verwenden kann, und nach den Reasoning-Optionen jedes Modells. Die Anfrage gibt nach 20 Sekunden auf. Ein Fehlschlag erscheint als Warnung im Hinweis, z. B. Cursor model discovery failed: …. Bis eine Erkennung gelingt, enthält die Liste nur das Standardmodell.
• Den Key ändern. Das Speichern eines neuen Keys leert die gefundenen Modelle und führt, wenn Cursor an ist, die Erkennung erneut aus. War schon ein Key gespeichert, stoppt das Relay außerdem jeden Cursor-Worker, auch einen mitten in einem Turn; speichere einen neuen Key also zwischen Turns. Die Worker starten bei der nächsten Nachricht mit dem neuen Key neu.
• Das Entfernen des Keys wird abgelehnt, solange eine Cursor-Konversation eine Nachricht gesendet oder Nachrichten eingereiht hat: Cannot remove Cursor API key while N active Cursor conversation(s) still exist. Disable Cursor for new conversations instead. So ist kein laufender Turn von einem Entfernen betroffen. Schalte Cursor stattdessen aus. Geht das Entfernen durch, wechseln Konversationen, die noch keine Nachricht gesendet haben, zurück zu Copilot. Cursor auszuschalten verschiebt sie nicht.

Starte dann eine Konversation wie gewohnt: Wähl in New Chat den Provider Cursor SDK. Siehe Eine Konversation starten.

Modelle und Effort #

Woher die Liste kommt. Von Cursor selbst, über deinen Key, zu den oben genannten Zeitpunkten. 🤗 Select Models → Cursor SDK legt fest, welche davon der Eingabebereich anbietet; 💾 Save enabled models (Aktivierte Modelle speichern) behält die Auswahl, und Refresh (Aktualisieren) führt die Erkennung erneut aus. Ohne Auswahl werden alle gefundenen Modelle angeboten. Das Modell in Cursor model ID wird immer angeboten.

Pro Nachricht. Eine Konversation kann Modell und Effort von einer Nachricht zur nächsten ändern; Cursor-Modell-IDs werden so verwendet, wie Cursor sie schreibt. Eine ID, die nicht unter den dir angebotenen Modellen ist (den aktivierten, plus Cursor model ID und dem eigenen Modell der Konversation), wird mit Cursor model "…" is not available abgelehnt.

Effort. Die Effort-Auswahl kommt vom Modell, so wie es sie auflistet. OAR kennt diese Stufen: none, low, medium, high, xhigh und max. Cursors extra-high erscheint als xhigh. Eine Stufe, die OAR nicht kennt, wird nicht angeboten.

• none steht immer in der Liste. Kann das Modell das Reasoning abschalten, tut none das. Kann es das nicht, zeigt der Eingabebereich den Eintrag als default (Standard), und das Modell läuft wie üblich.
• Ein Modell, das keinen Effort auflistet, hat nur none, angezeigt als default.
• Bei einem Modell mit einem Thinking-Schalter schaltet die Wahl einer Stufe Thinking ein und none schaltet es aus.

Subagents auf anderen Modellen. Cursors eingebautes Subagent-Menü bietet nur wenige Modelle an. OAR deklariert daher einen Subagent pro Modell, das du in Select Models aktiviert hast, damit der Agent einen Task z. B. an ein Grok- oder GPT-Modell abgeben kann. Namen verwenden Bindestriche (aus grok-4.5 wird grok-4-5). Ein Subagent läuft mit der Standardvariante seines Modells: Ihm lässt sich kein Effort geben. Eine Änderung der Auswahl wirkt ab der nächsten Nachricht.

Wie OARs Funktionen bei Cursor arbeiten #

Cursors eigene Projektregeln, Subagent-Dateien und MCP-Server im .cursor-Ordner des Arbeitsordners werden nicht geladen. OAR definiert die Tools und Subagents des Agents selbst.

Ein lange untätiger Agent #

Ein Cursor-Agent, der 30 Minuten nicht verwendet wurde, wird geschlossen und bei der nächsten Nachricht wieder geöffnet, weil seine Anmeldung nach einigen untätigen Stunden verfällt. Du merkst davon nichts. Ist die Anmeldung trotzdem verfallen, baut OAR den Agent neu und sendet die Nachricht erneut, bis zu zweimal, und fügt die Aktivitätszeile Cursor session re-authenticated; retrying this message on a fresh agent handle. hinzu. Ein dritter Fehlschlag beendet den Turn mit der Anmeldemeldung unter Wenn es nicht funktioniert.

Verbrauch #

Cursor-Turns haben keine Verbrauchszeile unter der Antwort. 📊 Check Usage (Verbrauch prüfen) hat eine Cursor-Karte. Solange Cursor aus ist, zeigt sie Cursor is not enabled in provider settings. Ihre Zahlen kommen aus zwei Quellen, und die Karte sagt, welche sie verwendet hat.

Ausgaben aus OAR, eine Schätzung. Nach jedem Turn liest OAR die berechneten Ausgaben des Agents bei Cursor und bucht den Anstieg auf den aktuellen Abrechnungszeitraum. Es ordnet jeden Turn dem Pool des Modells zu, das ihn ausgeführt hat:

Der Abgleich ignoriert Groß- und Kleinschreibung, und die Router-Namen werden zuerst geprüft.

Cursor sagt dem SDK nicht, was dein Plan enthält. Das gibst du ein:

Die Anzeigen messen die reinen Modellkosten an deinem Kontingent. Die Karte listet auch, was Cursor tatsächlich berechnet hat, was bei im Plan enthaltener Nutzung oft null ist. Alle diese Zahlen sind Schätzungen. Kosten, die Cursor spät meldet, werden mit dem Turn gebucht, der sie sieht. Cursors eigenes Spending-Dashboard ist die maßgebliche Quelle, und die Karte verlinkt darauf.

Live-Plan-Balken aus dem Dashboard. Mit einem Dashboard-Session-Token fügt die Karte die Balken Plan usage (total) (Plan-Verbrauch, gesamt), Auto + Composer und API hinzu, live aus Cursors Dashboard gelesen, sowie den Plan-Namen, die enthaltenen und On-Demand-Ausgaben und die echten Daten des Zeitraums. Die lokalen Pool-Anzeigen rücken dann an zweite Stelle. Das Token ist ein Session-Cookie, nicht der API-Key, und der API-Key kann diese Zahlen nicht lesen.

OAR sucht ein Token in dieser Reihenfolge:

1. Das, das du gespeichert hast.
2. CURSOR_SESSION_TOKEN in der Umgebung des Relays, für Hosts ohne Cursor-App.
3. Die Anmeldung der Cursor-App auf dem Rechner des Relays, aus ihrem lokalen Zustand gelesen, ohne Einrichtung.

Die Statuszeile unter dem Feld nennt die verwendete Quelle. Das Token bleibt auf dem Relay und wird nie an einen Browser geschickt. Akzeptiert Cursor das Token nicht, fällt die Karte auf die Schätzungen zurück und sagt, welche Quelle abgelehnt wurde oder dass kein Token gefunden wurde.

Ein Agent kann dieselben Zahlen mit der Aktion usage von relay_tool lesen.

Umgebungsvariablen #

Setz diese in der Umgebung, in der das Relay startet.

Der API-Key lässt sich so nicht setzen: Das Relay übergibt seinen Workern den Key aus dem Panel und ignoriert einen CURSOR_API_KEY in seiner eigenen Umgebung.

Grenzen #

Über die Lücken in der Tabelle oben hinaus (kein Nachsteuern, keine Task-Leiste, keine Einstellung für die Kompaktierung, nur eine Subagent-Ebene):

• Rückfrage-Karten hängen davon ab, dass der Agent ask_user aufruft.
• Ausgaben und Kontingente sind Schätzungen. Nur die Dashboard-Balken kommen von Cursor.
• Ein Nutzungslimit deines Cursor-Plans pausiert die Konversation nicht. Der Turn schlägt fehl wie jeder fehlgeschlagene Turn, und du sendest die Nachricht erneut.

Wenn es nicht funktioniert #