Используй 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.
Используй 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‑ключ в своей панели управления Cursor.
Надёжно сохрани свой API‑ключ Cursor в репозитории:
- Перейди в свой репозиторий на GitHub
- Нажми Settings → Secrets and variables → Actions
- Нажми New repository secret
- Назови его
CURSOR_API_KEY
- Вставь свой API‑ключ в поле значения
- Нажми Add secret
Установи переменную окружения CURSOR_API_KEY:
env:
CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}