Kod analizi, üretimi ve refaktörleme işleri için script’lerde ve otomasyon iş akışlarında Cursor CLI kullan.
Etkileşimsiz betikleme ve otomasyon için print mode (-p, --print) kullan.
Betiklerde dosya değiştirme
Betiklerde dosyaları değiştirmek için --print ile --force’u birleştir:
# Yazdırma 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 "Bu dosyaya kapsamlı JSDoc açıklamaları ekle: $file"
done
--force bayrağı, ajanın onay almadan doğrudan dosyalarda değişiklik yapmasına izin verir
Eksiksiz kurulum ayrıntıları için Installation ve Authentication bölümlerine göz at.
# 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 "Bu kodu analiz et"
Farklı script ihtiyaçların için farklı çıktı formatları kullan. Ayrıntılar için Çıktı formatı sayfasına bak.
Okunabilir yanıtlar için --output-format text kullan:
#!/bin/bash
# Basit bir kod tabanı sorusu
cursor-agent -p --output-format text "Bu kod tabanı ne yapıyor?"
Yapılandırılmış analiz için --output-format json kullan:
#!/bin/bash
# simple-code-review.sh - Basit kod gözden geçirme betiği
echo "Kod gözden geçirme başlıyor..."
# Son değişiklikleri gözden geçir
cursor-agent -p --force --output-format text \
"Son kod değişikliklerini gözden geçir ve şu konularda geri bildirim ver:
- Kod kalitesi ve okunabilirlik
- Olası hatalar veya sorunlar
- Güvenlikle ilgili hususlar
- En iyi uygulama standartlarına uyumluluk
İyileştirme için somut öneriler sun ve review.txt dosyasına yaz"
if [ $? -eq 0 ]; then
echo "✅ Kod gözden geçirme başarıyla tamamlandı"
else
echo "❌ Kod gözden geçirme başarısız oldu"
exit 1
fi
Gerçek zamanlı ilerleme takibi
Gerçek zamanlı ilerlemeyi takip etmek için --output-format stream-json kullan:
#!/bin/bash
# stream-progress.sh - Gerçek zamanlı ilerlemeyi izle
echo "🚀 Akış işleme başlatılıyor..."
# Gerçek zamanlı ilerlemeyi izle
accumulated_text=""
tool_count=0
start_time=$(date +%s)
cursor-agent -p --force --output-format stream-json \
"Bu projenin 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")
# Akıştaki 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ç bilgilerini çı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