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 із задачі), де агенту потрібен реальний робочий простір, а не лише текстовий контекст.