Kod analizi, üretimi ve refactoring görevleri için betiklerde ve otomasyon iş akışlarında Cursor CLI kullan.

​
Nasıl çalışır

Etkileşimsiz betikler ve otomasyon için print modu (-p, --print) kullan.

​
Betiklerde dosya değiştirme

Betiklerde dosyaları değiştirmek için --print ile --force’u birlikte kullan: 
# Print modunda dosya değişikliklerini etkinleştir
cursor-agent -p --force "Bu kodu modern ES6+ sözdizimini kullanacak şekilde yeniden düzenle"

# --force olmadan değişiklikler yalnızca önerilir, uygulanmaz
cursor-agent -p "Bu dosyaya JSDoc açıklamaları ekle"  # Dosyaları değiştirmez

# Gerçek dosya değişiklikleriyle toplu işleme
find src/ -name "*.js" | while read file; do
  cursor-agent -p --force "$file için kapsamlı JSDoc açıklamaları ekle"
done
--force bayrağı, aracın onay almadan doğrudan dosya değişiklikleri yapmasına izin verir

​
Kurulum

Tam kurulum ayrıntıları için Kurulum ve Kimlik Doğrulama bölümlerine bak. 
# Cursor CLI'yi yükle
curl https://cursor.com/install -fsS | bash

# Betikler için API anahtarını ayarla  
export CURSOR_API_KEY=your_api_key_here
cursor-agent -p "Analyze this code"

​
Örnek script’ler

Farklı script ihtiyaçları için farklı çıktı formatları kullan. Ayrıntılar için Çıktı formatı sayfasına bak.

​
Kod tabanında arama

Okunabilir yanıtlar için --output-format text kullan: 
#!/bin/bash
# Basit kod tabanı sorusu

cursor-agent -p --output-format text "Bu kod tabanı ne yapıyor?"

​
Otomatik kod incelemesi

Yapılandırılmış analiz için --output-format json kullan: 
#!/bin/bash
# simple-code-review.sh - Temel kod inceleme script'i

echo "Kod incelemesi başlatılıyor..."

# Son değişiklikleri incele
cursor-agent -p --force --output-format text \
  "Son kod değişikliklerini incele ve şu konularda geri bildirim ver:
  - Kod kalitesi ve okunabilirlik  
  - Olası hatalar veya sorunlar
  - Güvenlik değerlendirmeleri
  - En iyi uygulamalara uyum

  İyileştirme için somut önerilerde bulun ve review.txt dosyasına yaz"

if [ $? -eq 0 ]; then
  echo "✅ Kod incelemesi başarıyla tamamlandı"
else
  echo "❌ Kod incelemesi başarısız oldu"
  exit 1
fi

​
Gerçek zamanlı ilerleme takibi

Gerçek zamanlı ilerleme takibi için --output-format stream-json kullan: 
#!/bin/bash
# stream-progress.sh - İlerlemeyi gerçek zamanlı takip et

echo "🚀 Akış işleme başlatılıyor..."

# İlerlemeyi gerçek zamanlı takip et
accumulated_text=""
tool_count=0
start_time=$(date +%s)

cursor-agent -p --force --output-format stream-json \
  "Bu proje yapısını analiz et ve analysis.txt içinde bir özet rapor oluştur" | \
  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 "🤖 Kullanılan model: $model"
        fi
        ;;
        
      "assistant")
        # Akan metin deltalarını biriktir
        content=$(echo "$line" | jq -r '.message.content[0].text // empty')
        accumulated_text="$accumulated_text$content"
        
        # Canlı ilerlemeyi göster
        printf "\r📝 Üretiliyor: %d karakter" ${#accumulated_text}
        ;;
        
      "tool_call")
        if [ "$subtype" = "started" ]; then
          tool_count=$((tool_count + 1))
          
          # Araç bilgisini çıkar
          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🔧 Araç #$tool_count: $path oluşturuluyor"
          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📖 Araç #$tool_count: $path okunuyor"
          fi
          
        elif [ "$subtype" = "completed" ]; then
          # Araç sonuçlarını çıkar ve göster
          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 "   ✅ $lines satır oluşturuldu ($size bayt)"
          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 "   ✅ $lines satır okundu"
          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🎯 ${duration}ms içinde tamamlandı (toplam ${total_time}s)"
        echo "📊 Son istatistikler: $tool_count araç, ${#accumulated_text} karakter üretildi"
        ;;
    esac
  done