Перейти к основному содержанию
Используй Cursor CLI в GitHub Actions и других системах CI/CD, чтобы автоматизировать задачи разработки.

Интеграция с GitHub Actions

Базовая конфигурация:
- name: Установка Cursor CLI
  run: |
    curl https://cursor.com/install -fsS | bash
    echo "$HOME/.cursor/bin" >> $GITHUB_PATH

- name: Запуск Cursor Agent
  env:
    CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}
  run: |
    cursor-agent -p "Твой промпт здесь" --model gpt-5

Примеры из «книги рецептов»

Смотри наши примеры с практическими сценариями: обновление документации и исправление проблем в CI.

Другие CI‑системы

Используй Cursor CLI в любой CI/CD‑системе с:
  • возможностью запускать shell‑скрипты (bash, zsh и т. д.)
  • переменными окружения для настройки ключа API
  • доступом в интернет для обращения к API Cursor

Уровни автономности

Выбери уровень автономности агента:

Полная автономность

Дай агенту полный контроль над операциями с git, API-вызовами и внешними интеграциями. Настройка проще, но требует больше доверия. Пример: В нашем рецепте Update Documentation первый сценарий позволяет агенту:
  • Анализировать изменения в PR
  • Создавать и управлять ветками git
  • Коммитить и пушить изменения
  • Оставлять комментарии в pull request’ах
  • Обрабатывать все ошибки
- name: Обновить документацию (полная автономность)
  run: |
    cursor-agent -p "У тебя есть полный доступ к git, GitHub CLI и операциям с PR. 
    Веди весь процесс обновления документации, включая коммиты, пуши и комментарии к PR."

Подход с ограниченной автономией

Рекомендуем использовать этот подход с ограничениями на основе разрешений для продакшен‑CI‑воркфлоу. Это сочетает лучшее из обоих миров: агент может умно выполнять сложный анализ и вносить изменения в файлы, а критически важные операции остаются детерминированными и поддающимися аудиту.
Ограничивай операции агента, а критические этапы выноси в отдельные шаги воркфлоу. Больше контроля и предсказуемости. Пример: Второй воркфлоу в этом же сборнике рецептов ограничивает агента только изменениями файлов:
- name: Генерация обновлений документации (с ограничениями)
  run: |
    cursor-agent -p "ВАЖНО: не создавай ветки, не выполняй commit, push и не оставляй комментарии в PR. 
    Меняй только файлы в рабочем каталоге. Публикацией займётся следующий шаг workflow."

- name: Публикация ветки документации (детерминированно)
  run: |
    # Детерминированные операции git выполняются CI
    git checkout -B "docs/${{ github.head_ref }}"
    git add -A
    git commit -m "docs: обновление для PR"
    git push origin "docs/${{ github.head_ref }}"

- name: Публикация комментария в PR (детерминированно)  
  run: |
    # Детерминированное комментирование PR выполняется CI
    gh pr comment ${{ github.event.pull_request.number }} --body "Документация обновлена"

Ограничения на базе разрешений

Используй конфигурации разрешений, чтобы применять ограничения на уровне CLI:
{
  "permissions": {
    "allow": [
      "Read(**/*.md)",
      "Write(docs/**/*)",
      "Shell(grep)",
      "Shell(find)"
    ],
    "deny": [
      "Shell(git)",
      "Shell(gh)", 
      "Write(.env*)",
      "Write(package.json)"
    ]
  }
}

Аутентификация

Сгенерируй свой API‑ключ

Сначала сгенерируй API‑ключ в своей панели управления Cursor.

Настрой секреты репозитория

Надёжно сохрани свой API‑ключ Cursor в репозитории:
  1. Перейди в свой репозиторий на GitHub
  2. Нажми SettingsSecrets and variablesActions
  3. Нажми New repository secret
  4. Назови его CURSOR_API_KEY
  5. Вставь свой API‑ключ в поле значения
  6. Нажми Add secret

Использование в workflow

Установи переменную окружения CURSOR_API_KEY:
env:
  CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}
I