Используй Cursor CLI в GitHub Actions и других CI/CD системах для автоматизации задач разработки.

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

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

- name: Run Cursor Agent
  env:
    CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}
  run: |
    cursor-agent -p "Your prompt here" --model gpt-5

Примеры из сборника рецептов

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

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

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

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

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

Подход с полной автономией

Дай агенту полный контроль над git-операциями, API-вызовами и внешними интеграциями. Настройка проще, но требуется больше доверия. Пример: В нашем рецепте Auto Update Documentation первый workflow позволяет агенту:
  • Анализировать изменения в PR
  • Создавать и управлять ветками git
  • Делать коммиты и пушить изменения
  • Оставлять комментарии в pull request’ах
  • Обрабатывать все ошибочные сценарии
- name: Update docs (full autonomy)
  run: |
    cursor-agent -p "You have full access to git, GitHub CLI, and PR operations. 
    Handle the entire docs update workflow including commits, pushes, and PR comments."

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

Мы рекомендуем использовать этот подход с ограничениями на основе разрешений для production CI workflow’ов. Это даёт лучшее из обоих миров: агент может интеллектуально обрабатывать сложный анализ и изменения файлов, а критические операции остаются детерминированными и подлежащими аудиту.
Ограничь действия агента, а критические шаги вынеси в отдельные шаги workflow. Больше контроля и предсказуемости. Пример: Второй workflow в том же рецепте ограничивает агента только изменениями файлов:
- name: Generate docs updates (restricted)
  run: |
    cursor-agent -p "IMPORTANT: Do NOT create branches, commit, push, or post PR comments. 
    Only modify files in the working directory. A later workflow step handles publishing."

- name: Publish docs branch (deterministic)
  run: |
    # Deterministic git operations handled by CI
    git checkout -B "docs/${{ github.head_ref }}"
    git add -A
    git commit -m "docs: update for PR"
    git push origin "docs/${{ github.head_ref }}"

- name: Post PR comment (deterministic)  
  run: |
    # Deterministic PR commenting handled by CI
    gh pr comment ${{ github.event.pull_request.number }} --body "Docs updated"

Ограничения на основе разрешений

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

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

Задай переменную окружения CURSOR_API_KEY:
env:
  CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}
API-ключ можно получить в настройках Cursor.