Использование Headless CLI
Используйте CLI Cursor в скриптах и автоматизированных рабочих процессах для анализа, генерации и рефакторинга кода.
Как это работает
Используйте режим вывода (-p, --print) для неинтерактивных сценариев и автоматизации.
Изменение файлов из скриптов
Чтобы изменять файлы из скриптов, используйте --print вместе с --force (или --yolo):
# Разрешить изменение файлов в режиме выводаagent -p --force "Refactor this code to use modern ES6+ syntax"# Без --force изменения только предлагаются, но не применяютсяagent -p "Add JSDoc comments to this file" # Файлы изменены не будут# Пакетная обработка с реальным изменением файловfind src/ -name "*.js" | while read file; do agent -p --force "Add comprehensive JSDoc comments to $file"doneФлаг --force позволяет Agent вносить изменения в файлы без
подтверждения
Настройка
Подробные сведения см. в разделах Установка и Аутентификация.
# Установка CLI Cursor (macOS, Linux, WSL)curl https://cursor.com/install -fsS | bash# Установка CLI Cursor (Windows PowerShell)irm 'https://cursor.com/install?win32=true' | iex# Задать API-ключ для скриптовexport CURSOR_API_KEY=your_api_key_hereagent -p "Analyze this code"Примеры скриптов
Используйте разные форматы вывода в зависимости от задачи скрипта. Подробнее см. в разделе Формат вывода.
Поиск по кодовой базе
По умолчанию --print использует формат text, возвращая только окончательный ответ:
#!/bin/bash# Простой вопрос о кодовой базе — по умолчанию используется формат textagent -p "What does this codebase do?"Автоматизированное ревью кода
Используйте --output-format json для структурированного анализа:
#!/bin/bash# simple-code-review.sh - базовый скрипт для code reviewecho "Starting code review..."# Ревью последних измененийagent -p --force --output-format text \ "Review the recent code changes and provide feedback on: - Code quality and readability - Potential bugs or issues - Security considerations - Best practices compliance Provide specific suggestions for improvement and write to review.txt"if [ $? -eq 0 ]; then echo "✅ Code review completed successfully"else echo "❌ Code review failed" exit 1fiОтслеживание прогресса в реальном времени
Используйте --output-format stream-json для отслеживания прогресса по сообщениям или добавьте --stream-partial-output для инкрементального стриминга дельт:
#!/bin/bash# stream-progress.sh - отслеживание прогресса в реальном времениecho "🚀 Starting stream processing..."# Отслеживаем прогресс в реальном времениaccumulated_text=""tool_count=0start_time=$(date +%s)agent -p --force --output-format stream-json --stream-partial-output \ "Analyze this project structure and create a summary report in analysis.txt" | \ while IFS= read -r line; do type=$(echo "$line" | jq -r '.type // empty') subtype=$(echo "$line" | jq -r '.subtype // empty') case "$type" in "system") if [ "$subtype" = "init" ]; then model=$(echo "$line" | jq -r '.model // "unknown"') echo "🤖 Using model: $model" fi ;; "assistant") # Обрабатываем только deltas стриминга (timestamp_ms есть, model_call_id нет). # Пропускаем буферизованные flush перед tool calls и в конце turn. has_ts=$(echo "$line" | jq 'has("timestamp_ms")') has_mc=$(echo "$line" | jq 'has("model_call_id")') if [ "$has_ts" = "true" ] && [ "$has_mc" = "false" ]; then content=$(echo "$line" | jq -r '.message.content[0].text // empty') accumulated_text="$accumulated_text$content" printf "\r📝 Generating: %d chars" ${#accumulated_text} fi ;; "tool_call") if [ "$subtype" = "started" ]; then tool_count=$((tool_count + 1)) # Извлекаем информацию об инструменте if echo "$line" | jq -e '.tool_call.writeToolCall' > /dev/null 2>&1; then path=$(echo "$line" | jq -r '.tool_call.writeToolCall.args.path // "unknown"') echo -e "\n🔧 Tool #$tool_count: Creating $path" elif echo "$line" | jq -e '.tool_call.readToolCall' > /dev/null 2>&1; then path=$(echo "$line" | jq -r '.tool_call.readToolCall.args.path // "unknown"') echo -e "\n📖 Tool #$tool_count: Reading $path" fi elif [ "$subtype" = "completed" ]; then # Извлекаем и выводим результаты работы инструмента if echo "$line" | jq -e '.tool_call.writeToolCall.result.success' > /dev/null 2>&1; then lines=$(echo "$line" | jq -r '.tool_call.writeToolCall.result.success.linesCreated // 0') size=$(echo "$line" | jq -r '.tool_call.writeToolCall.result.success.fileSize // 0') echo " ✅ Created $lines lines ($size bytes)" elif echo "$line" | jq -e '.tool_call.readToolCall.result.success' > /dev/null 2>&1; then lines=$(echo "$line" | jq -r '.tool_call.readToolCall.result.success.totalLines // 0') echo " ✅ Read $lines lines" fi fi ;; "result") duration=$(echo "$line" | jq -r '.duration_ms // 0') end_time=$(date +%s) total_time=$((end_time - start_time)) echo -e "\n\n🎯 Completed in ${duration}ms (${total_time}s total)" echo "📊 Final stats: $tool_count tools, ${#accumulated_text} chars generated" ;; esac doneРабота с изображениями
Чтобы отправлять Agent изображения, медиафайлы или другие двоичные данные, указывайте пути к файлам в промптах. Agent может читать любые файлы с помощью вызова инструментов, включая изображения, видео и файлы других форматов.
Указание путей к файлам в промптах
Просто укажите пути к файлам в тексте промпта. Agent автоматически прочитает нужные файлы:
# Анализ изображенияagent -p "Analyze this image and describe what you see: ./screenshot.png"# Обработка нескольких медиафайловagent -p "Compare these two images and identify differences: ./before.png ./after.png"# Сочетание путей к файлам с текстовыми инструкциямиagent -p "Review the code in src/app.ts and the design mockup in designs/homepage.png. Suggest improvements to match the design."Принцип работы
Когда вы указываете пути к файлам в промпте:
- Agent получает ваш промпт со ссылками на файлы
- Agent автоматически читает файлы с помощью вызова инструментов
- Изображения обрабатываются автоматически
- Вы можете ссылаться на файлы, используя относительные или абсолютные пути
Пример: Скрипт для анализа изображений
#!/bin/bash# analyze-image.sh - анализ изображений с помощью headless CLIIMAGE_PATH="./screenshots/ui-mockup.png"agent -p --output-format json \ "Analyze this image and provide a detailed description: $IMAGE_PATH" | \ jq -r '.result'Пример: пакетная обработка медиафайлов
#!/bin/bash# process-media.sh - пакетная обработка медиафайловfor image in images/*.png; do echo "Processing $image..." agent -p --output-format text \ "Describe what's in this image: $image" > "${image%.png}.description.txt"doneПути к файлам могут быть относительными относительно текущего рабочего каталога или абсолютными. Agent читает файлы с помощью вызовов инструментов, поэтому убедитесь, что файлы существуют и доступны из каталога, в котором вы запускаете команду.