Cursor Worktrees — это изолированные Git checkouts, в которых Agent правит код, не ломая ваш основной рабочий каталог. UI-native создание — в Agents Window; в IDE — slash-команды /worktree и /best-of-n. Канон: Worktrees.

Связка: Background Agents, Checkpoints, Model Picker. Pillar: n8n для начинающих.

Для кого Worktrees

  • Нужно несколько агентов на одном репо без конфликтов файлов.
  • Рискованный рефакторинг: отдельный checkout проще выкинуть.
  • Сравнение моделей на одном промпте через /best-of-n.
  • Хотите автоматический npm ci / venv при создании worktree.

Быстрый старт

  1. Agents Window: стартуйте или перенесите агента в worktree — Cursor сделает отдельный checkout.
  2. IDE: в чате напишите /worktree fix the failing auth tests.
  3. После результата — commit/PR из worktree или /apply-worktree в основной checkout.
  4. Уборка: /delete-worktree; список — git worktree list.
  5. Сравнение моделей: /best-of-n sonnet,gpt,composer fix the flaky logout test.
Способ Где Изоляция Мерж в main
Agents Window worktree Agents Window UI Отдельный checkout Review → commit/PR или apply
/worktree IDE chat Один checkout на задачу /apply-worktree или push из WT
/best-of-n IDE chat Checkout на каждую модель Вручную после выбора winner

Сверка: cursor.com/docs/configuration/worktrees (проверка 2026-09-10). UI-native worktrees docs относят к Agents Window; в IDE — Skills-команды.

worktrees.json: setup

Файл .cursor/worktrees.json. Порядок поиска: worktree path → корень проекта.

  • setup-worktree-unix / setup-worktree-windows — приоритетнее generic на своей ОС.
  • setup-worktree — fallback для всех ОС.
  • Значение: массив команд подряд или строка-путь к скрипту рядом с json.
  • $ROOT_WORKTREE_PATH — путь к основному checkout (удобно копировать .env).

Docs не рекомендуют symlink зависимостей в worktree — лучше быстрый package manager (bun, pnpm, uv). Отладка setup: Output → Worktrees Setup.

Setting (machine) Смысл Пример docs
cursor.worktreeCleanupIntervalHours Как часто чистить старые WT 6
cursor.worktreeMaxCount Макс. число WT на машину 25 (default cap)

Cleanup с Cursor 3.5: лимит общий на все workspace устройства; внешние git worktree add тоже eligible.

Сильные стороны

  • Параллельные агенты без порчи текущего branch.
  • Детерминированный setup через json/скрипты.
  • /best-of-n сравнивает модели без ручных клонов.

Типичные ошибки

  • Ждать, что /best-of-n сам смержит победителя в main.
  • Symlink node_modules из root — docs предостерегают.
  • Забыть скопировать secrets (.env) через ROOT_WORKTREE_PATH.
  • Упереться в MaxCount 25 и удивляться автоудалению старых WT.

FAQ: Cursor Worktrees

Что такое Cursor Worktrees?

Worktrees — изолированные Git checkouts для Agent: у каждой задачи свои файлы, зависимости и diff, основной checkout не трогают. UI-native worktrees — в Agents Window; в IDE — команды /worktree и /best-of-n. Канон: cursor.com/docs/configuration/worktrees.

Как настроить setup через worktrees.json?

Положите .cursor/worktrees.json с ключами setup-worktree, setup-worktree-unix или setup-worktree-windows. Значение — массив shell-команд или путь к скрипту. Cursor ищет файл сначала в worktree path, затем в корне проекта. Переменная ROOT_WORKTREE_PATH указывает на основной checkout.

Чем /worktree отличается от /best-of-n?

/worktree запускает одну задачу в отдельном checkout. /best-of-n гоняет один промпт на нескольких моделях, каждой — свой worktree. /best-of-n сам не мержит победителя: commit из worktree или /apply-worktree.

Как Cursor чистит старые worktrees?

С Cursor 3.5 cleanup идёт по интервалу и лимиту cursor.worktreeMaxCount (по умолчанию 25 на машину на все workspace). Интервал — cursor.worktreeCleanupIntervalHours (пример docs: 6). Worktrees, созданные через git worktree add или skills, тоже попадают под cleanup.

Где смотреть лог setup?

Откройте Output panel в редакторе и выберите канал Worktrees Setup. Там видны команды из worktrees.json и ошибки install/migrate.

Вывод

Cursor Worktrees — изоляция задач агента на уровне Git checkout. Настройте worktrees.json, держите лимит cleanup, для сравнения моделей берите /best-of-n. Окно агентов — Agents Window; биллинг моделей — Models & Pricing.

Артём Денисов — эксперт Нетологии и автор курса Яндекс Практикума по промпт-инжинирингу. Разбирает Worktrees по официальным docs без выдуманных CLI-флагов.

Хотите нейросети под свои задачи, а не «для всех»?

Когда базовых гайдов уже мало, помогает разбор под вашу работу. Наставничество, курсы и подписка Артём Денисов — все форматы на странице обучения. Тех-pillar — n8n для начинающих.