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