Wir stellen das Cursor SDK vor, damit du Agenten mit derselben Laufzeitumgebung, demselben Harness und denselben Modellen erstellen kannst, auf denen auch Cursor basiert.

Die Agenten, die in der Cursor-Desktop-App, der CLI und der Web-App laufen, lassen sich jetzt mit nur wenigen Zeilen TypeScript nutzen. Du kannst sie auf deinem Rechner oder in Cursors Cloud auf einer dedizierten VM ausführen – mit jedem Frontier-Modell.

Agenten entwickeln sich von interaktiven Tools für einzelne Entwickler zu programmgesteuerter Infrastruktur für Organisationen. Mit dem Cursor SDK kannst du Agenten bereitstellen, ohne den Aufwand für Aufbau und Wartung des gesamten Agent-Stacks. Viele Teams rufen Agenten bereits direkt aus CI/CD-Pipelines auf, erstellen Automatisierungen für End-to-End-Workflows und integrieren Agenten in ihre Kernprodukte.

Das Cursor SDK ist jetzt in der öffentlichen Beta für alle Benutzer verfügbar. Führe einfach npm install @cursor/sdk aus, um erste Schritte zu machen.

import { Agent } from "@cursor/sdk";

const agent = await Agent.create({
  apiKey: process.env.CURSOR_API_KEY!,
  model: { id: "composer-2" },
  local: { cwd: process.cwd() },
});

const run = await agent.send("Summarize what this repository does");

for await (const event of run.stream()) {
  console.log(event);
}

#Agenten schnell in Produktion bringen

Schnelle, zuverlässige und leistungsfähige Agenten zu erstellen, die sicher mit deinen Daten arbeiten, erfordert erheblichen Entwicklungsaufwand: sicheres Sandboxing, persistente Zustands- und Sitzungsverwaltung, das Einrichten der Umgebung und Kontextverwaltung. Und wenn ein neues Modell erscheint, müssen Teams ihre Agent Loops oft überarbeiten, um davon zu profitieren.

Das Cursor SDK nimmt dir diese Komplexität ab, damit du dich auf das Erstellen nützlicher Agenten konzentrieren kannst.

Produktionsreife Cloud-Infrastruktur nutzen

Cloud-Sitzungen, die aus dem SDK initiiert werden, laufen auf derselben optimierten Laufzeitumgebung, die wir für Cloud-Agent nutzen. Jeder Agent erhält seine eigene dedizierte VM mit starkem Sandboxing, einem Klon des Repos und einer vollständig konfigurierten Entwicklungsumgebung.

Agenten laufen weiter, wenn dein Laptop in den Ruhezustand geht oder die Netzwerkverbindung abbricht. Du kannst die Unterhaltung streamen und dich später erneut verbinden. Wenn der Agent fertig ist, kann er eine PR öffnen, einen Branch pushen oder Demos und Screenshots hinzufügen.

// Cloud-Agent starten, um eine Aufgabe zu beginnen...:
const agent = await Agent.create({
  apiKey: process.env.CURSOR_API_KEY!,
  model: { id: "gpt-5.5" },
  cloud: {
    repos: [{ url: "https://github.com/cursor/cookbook", startingRef: "main" }],
    autoCreatePR: true,
  },
});

const run = await agent.send("Fix the auth token expiry bug");
console.log(`Started ${run.id}`);

// ...später von überall wieder nachschauen:
const result = await (
  await Agent.getRun(run.id, { runtime: "cloud", agentId: run.agentId })
).wait();
console.log(result.git?.branches[0]?.prUrl);

Das SDK nutzt unsere aktualisierte Cloud Agents API, mit der Cloud-Agent-Läufe im Agents-Fenster und in der Web-App von Cursor angezeigt werden können. Du kannst eine Aufgabe programmgesteuert starten und dann in Cursor wechseln, um den Fortschritt zu prüfen oder die Arbeit zu übernehmen.

Wenn du eine andere Laufzeitumgebung brauchst, kann dasselbe SDK Agenten auf selbstgehosteten Workern ausführen, sodass Code und Tool-Ausführung in deinem Netzwerk bleiben, oder lokal auf deinem Rechner für schnelle Iterationen.

Nutze das vollständige Cursor-Harness

Agenten, die über das SDK gestartet werden, profitieren vom selben Harness, das Cursor in unserer Desktop-App, CLI und Web-App antreibt:

• Intelligentes Kontextmanagement: Indizierung der Codebasis, semantische Suche und Instant Grep helfen Agenten, schneller und effizienter zum richtigen Ergebnis zu kommen.
• MCP-Server: Agenten können sich über stdio oder HTTP mit externen Tools und Datenquellen verbinden, entweder über eine Konfigurationsdatei .cursor/mcp.json oder direkt inline im Aufruf.
• Skills: Agenten übernehmen automatisch Skills aus dem Verzeichnis .cursor/skills/ deines Repos.
• Hooks: Beobachte, steuere und erweitere den Agent Loop über Cloud-, selbstgehostete und lokale Umgebungen hinweg mit einer Datei .cursor/hooks.json.
• Subagents: Delegiere Teilaufgaben an benannte Subagents mit eigenen Prompts und Modellen, die der Haupt-Agent über das Tool Agent startet.

Auf jedem Modell aufbauen

Das Cursor SDK gibt dir Zugriff auf jedes in Cursor unterstützte Modell. Leite Agenten mit einer einzigen Feldänderung an das beste Modell für die jeweilige Aufgabe weiter – mit der von dir gewünschten Balance aus Kosten und Fähigkeit.

Und mit Composer 2, einem spezialisierten Coding-Modell, das Frontier-Level-Performance zu einem Bruchteil der Kosten allgemeiner Modelle erreicht, erhältst du für die meisten Aufgaben von Coding-Agenten die beste Kombination aus Intelligenz und Effizienz.

#Was Entwickler entwickeln

Teams nutzen das Cursor SDK, um eigene Agenten schneller bereitzustellen. Zum Beispiel programmgesteuerte Agenten, die direkt über CI/CD angestoßen werden, um Änderungen zusammenzufassen, die eigentliche Ursache von CI-Fehlern zu finden und PRs mit Korrekturen zu aktualisieren. Andere entwickeln benutzerdefinierte Agent-Plattformen, etwa interne Anwendungen, mit denen GTM-Teams Produktdaten abfragen können, ohne Code schreiben zu müssen.

Einige Kunden binden Cursor sogar direkt in kundenorientierte Produkte ein, sodass Endnutzer jetzt ein Agent-Erlebnis erhalten, ohne die Host-Anwendung zu verlassen.

Hier berichten einige unserer Kunden direkt, die auf dem Cursor SDK aufbauen:

#Mit einem Beispielprojekt starten

Wir haben einige Starterprojekte in einem öffentlichen GitHub-Repo hinzugefügt, die du forken und für deine eigenen Anwendungsfälle erweitern kannst:

• Quickstart: Ein minimales Node.js-Beispiel, das einen lokalen Agent erstellt, einen Prompt sendet und die Antwort streamt.
• Prototyping-Tool: Eine Web-App, mit der du Agenten starten kannst, um neue Projekte aufzusetzen und Ideen in einer isolierten Cloud-Umgebung iterativ weiterzuentwickeln.
• Kanban-Board: Ein agentengestütztes Kanban-Tool, in dem Ingenieure eine Karte ziehen und Agenten die Arbeit programmgesteuert übernehmen, eine PR öffnen und das Ergebnis als Anhang zurücksenden lassen können.
• Coding-Agent-CLI: Eine schlanke Befehlszeilenoberfläche, mit der du Cursor Agenten direkt aus deinem Terminal starten kannst.

#Wie geht es weiter?

Das Cursor SDK ist für alle Benutzer verfügbar und wird nach dem standardmäßigen, tokenbasierten Nutzungsmodell abgerechnet.

Wir investieren weiterhin in das Cursor SDK und arbeiten daran, es für Teams noch einfacher zu machen, programmgesteuerte Agenten in noch mehr Sprachen, Workflows und Deployment-Mustern zu erstellen.

Weitere Informationen findest du in unserer Dokumentation. Du kannst Cursor auch mit unserem Cursor SDK Plugin nutzen, um den Einstieg ins Erstellen zu erleichtern.