GitHub Actions
Используйте CLI Cursor в 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: | agent -p "Your prompt here" --model gpt-5Для раннеров Windows используйте PowerShell: irm 'https://cursor.com/install?win32=true' | iex
Примеры из cookbook
Практические рабочие процессы см. в наших примерах из cookbook: обновление документации и исправление проблем CI.
Другие системы CI
Используйте CLI Cursor в любой системе CI/CD, где есть:
- Возможность выполнять shell-скрипты (bash, zsh и т. д.)
- Переменные среды для настройки API-ключа
- Подключение к интернету для доступа к API Cursor
Уровни автономности
Выберите уровень автономности Agent:
Подход с полной автономией
Предоставьте Agent полный контроль над операциями Git, вызовами API и внешними взаимодействиями. Настройка проще, но требует большего доверия.
Пример: В нашем cookbook Update Documentation первый рабочий процесс позволяет Agent:
- Анализировать изменения в PR
- Создавать ветки Git и управлять ими
- Выполнять commit и push изменений
- Публиковать комментарии в pull request
- Обрабатывать все сценарии ошибок
- name: Update docs (full autonomy) run: | 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."Подход с ограниченной автономностью
Мы рекомендуем использовать этот подход с ограничениями на основе прав доступа в CI-процессах для продакшена. Это позволяет совместить лучшее из обоих подходов: Agent может эффективно выполнять сложный анализ и изменять файлы, а критически важные операции остаются детерминированными и поддаются аудиту.
Ограничивайте операции Agent, вынося критически важные действия в отдельные этапы рабочего процесса. Это обеспечивает лучший контроль и предсказуемость.
Пример: Второй рабочий процесс в том же cookbook позволяет Agent только изменять файлы:
- name: Generate docs updates (restricted) run: | 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: | # Детерминированные git-операции выполняет 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: | # Детерминированное комментирование PR выполняет 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)"] }}Аутентификация
Создайте API-ключ
Сначала создайте API-ключ на дашборде Cursor.
Настройте секреты репозитория
Безопасно сохраните API-ключ Cursor в репозитории с помощью GitHub CLI:
# Секрет репозиторияgh secret set CURSOR_API_KEY --repo OWNER/REPO --body "$CURSOR_API_KEY"# Секрет организации (для всех репозиториев)gh secret set CURSOR_API_KEY --org ORG --visibility all --body "$CURSOR_API_KEY"Или используйте интерфейс GitHub: откройте свой репозиторий → Settings → Secrets and variables → Actions → New repository secret
Использование в рабочих процессах
Задайте переменную среды CURSOR_API_KEY:
env: CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}