cursor публикува cookbook за своя agent sdk

github.com/cursor/cookbook

TL;DR: cursor отвори хранилище с примери за @cursor/sdk — typescript-обвивка около техния агент за код. sdk пуска агента локално (чете файлове от диска) или в облачна vm с клонирано хранилище, излъчва поток от събития на изпълнението, поддържа избор на модел, отказ, mcp и запазване на състоянието на диалога между изпълненията. В cookbook има четири примера: quickstart, прототипатор, kanban за облачни агенти и стартер от терминала.

Какво има в хранилището

• quickstart — минимален скрипт на node: създаване на локален агент, изпращане на заявка, обхождане на потока от събития.
• prototyping tool — уеб приложение за генериране на заготовки на проекти и итерации в облачна пясъчник.
• kanban board — интерфейс за преглед на облачни агенти с групиране по статус или хранилище, плюс създаване на нови.
• coding agent cli — стартиране на агенти от терминала.

sdk накратко

npm install @cursor/sdk

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);
}

Ключът CURSOR_API_KEY се взема от панела на cursor. Един интерфейс за три среди за изпълнение: локален node, облак на cursor, собствен облак. Един run е единица работа за една заявка; агентът пази контекст между тях. Има Cursor.models.list(), отказ на изпълнение с прекъсване на текущите извиквания на инструменти, mcp-сървъри (през обект, файл или панел на cursor).

Context

Cookbook излиза на фона на общия завой на cursor към агентите като първокласен примитив: през април 2026 те пуснаха cursor 3 с интерфейс, ориентиран към агенти — паралелни агенти по хранилища и среди, постоянни canvases в страничния панел. През март се появиха cursor automations — тригери за агенти от комит, съобщение в slack или таймер. Sdk е логично продължение: това, което прави бутон вътре в редактора, вече може да се извиква от ci, скриптове и външни приложения.

Прякото сравнение е claude agent sdk и openai assistants/agents api. Разликата при cursor е първичната връзка с кода и хранилищата: облачната среда клонира хранилището в изолирана vm, локалната чете работната директория. Това е удобно за масови задачи по кодова база (рефакторинги, авто-поправки от линтер, генериране на pr от задача), където агентът се нуждае от реално работно пространство, а не само текстов контекст.