Используй 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 и внешними взаимодействиями. Настройка проще, но требуется больше доверия. Пример: В рецепте 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)"
    ]
  }
}

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

​
Сгенерируй API-ключ

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

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

Храни свой Cursor API-ключ в репозитории безопасно:
  1. Зайди в свой репозиторий на GitHub
  2. Нажми Settings → Secrets and variables → Actions
  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 }}