Все мы привыкли, что AI ассистенты вроде Copilot или Cursor болтаются в редакторе и отвечают на запросы. Но что если AI сам может запустить тесты, создать пул-реквест и исправить багу? Знакомьтесь, Cursor SDK — это не просто автокомплит, это программируемый агент, который ты контролируешь через API.

Я недавно тестил эту штуку для автоматизации ревью PRов и мелких рутинных исправлений в легаси. Смотрите, какая штука: Cursor SDK позволяет писать скрипты, которые запускают Devina — агента внутри Cursor — в автоматическом режиме.

Как это работает

Берешь Python (или TypeScript) скрипт, подключаешься к агенту через WebSocket, отправляешь промпт — и он в изолированном окружении поднимает Cursor, делает изменения, коммитит, пушит. Всё это через SDK.

Пример простого скрипта (TS)

Вот как выглядел мой первый тест, чтобы прогнать Prettier по всем файлам в проекте и закоммитить:

import { DevinaClient } from 'cursor-sdk';

const client = new DevinaClient('ваш-токен');

async function fixFormatting() {
  const session = await client.createSession({
    project: '/projects/my-app',
    initCommands: ['npm install'],
  });

  await session.runPrompt('"Отформатируй все TS и JS файлы через Prettier, создай коммит и запушь в текущую ветку. Если есть ошибки — выведи в консоль."');

  const result = await session.waitForCompletion();
  console.log(result.summary);
}

fixFormatting();

Что важно: сессия живёт максимум 5 минут, и если не уложился — всё отменяется.

Сценарии использования

1. Автоматизация Code Review

Есть PR с правками по тикету — можно дернуть агента, который проверит тесты, прогонит линтер и даже подправит нейминг. Экономит 3-5 часов в неделю на мелких ревью.

2. Рефакторинг легаси

DSL 10-летней давности на CoffeeScript? Дай агенту контекст и попроси переписать на современный TS. SDK сам создаст ветку, закоммитит и запросит ревью у тебя.

3. Onboarding новых разрабов

Сделал скрипт, который разворачивает репозиторий, поднимает бекенд, фронт, базу, и запускает интеграционные тесты. Новичок просто запускает — и всё готово.

Цена вопроса

Cursor SDK — платный. Стоит $39/месяц за пользователя в тарифе Business. Но если ты используешь его в CI/CD или для агентных скриптов на сервере, это того стоит. Есть лимит: 90 запусков агента в час на пользователя. Если пройдёшь — получаешь 429 ошибку.

Подводные камни (на личном опыте)

• Таймауты: Агент может тупить на больших проектах (10к+ файлов). Он не загружает всё подряд, а индексирует лениво, но если в промпте попросить «проверить все файлы на предмет X» — он может умереть по таймауту.
• Контекст: Максимальная длина промпта — 128K токенов. Вроде много, но если ты передаёшь структуру проекта + код пары модулей, легко упереться. Решение — писать промпты по принципу «сначала найди, потом измени». За один запрос не делай всё сразу.
• Ошибки в коде: Сейчас агент иногда генерирует код, который не компилится. SDK не проверяет синтаксис за тебя — только запускается и отдаёт результат. Обязательно ставь tcs --noEmit в initCommands.
• Стоимость для команды: Если у вас 5+ девелоперов, то $195/мес за Business — это нормально. Но если хочешь повесить на CI — покупай отдельную лицензию для CI-юзера. Не экономь, иначе будет жесткая блокировка.

Промпт для ревью пул-реквеста

Брось агенту в начале сессии такой системный промпт, чтобы он был полезнее:

Ты — опытный senior разработчик, ревьюируешь пул-реквест. Для каждого изменения:
- Оцени безопасность (SQL инъекции, XSS, раскрытие данных).
- Проверь покрытие тестами. Если нет новых тестов на новый функционал — верни ошибку.
- Предложи рефакторинг, если код дублируется или не следует SOLID.
- Напиши короткий summary для коммита в gitmoji.

Итог

Cursor SDK — мощная штука, если ты не боишься настраивать с нуля. Для меня это уже рабочий инструмент: ревью мелких PRов, автофикс форматирования, рефакторинг устаревшего кода. Да, есть нюансы с контекстом и таймаутами, но потенциал огромен.

Как вы автоматизируете рутину сейчас?

Кто-то юзает bash-скрипты, кто-то GitHub Actions, кто-то платит кучу денег за Copilot Workspace. Интересно, кто уже пробовал Cursor SDK в CI и как подкручивали промпты, чтобы агент не тупил? Делитесь кейсами в комментариях — может, придумаем что-то ещё круче.