Langsung ke konten utama
Pakai Cursor CLI di skrip dan alur otomatis buat analisis kode, pembuatan, dan refactoring.

Cara kerjanya

Gunakan print mode (-p, --print) untuk skrip non-interaktif dan otomatisasi.

Modifikasi file di skrip

Padukan --print dengan --force untuk mengubah file di skrip:
# Aktifkan modifikasi file dalam mode cetak
cursor-agent -p --force "Refactor kode ini agar menggunakan sintaks ES6+ modern"

# Tanpa --force, perubahan hanya diusulkan, tidak diterapkan
cursor-agent -p "Tambahkan komentar JSDoc ke file ini"  # Tidak akan memodifikasi file

# Pemrosesan batch dengan perubahan file sesungguhnya
find src/ -name "*.js" | while read file; do
  cursor-agent -p --force "Tambahkan komentar JSDoc yang komprehensif ke $file"
done
Flag --force memungkinkan agen melakukan perubahan file secara langsung tanpa konfirmasi

Penyiapan

Lihat Instalasi dan Autentikasi untuk detail penyiapan lengkap.
# Instal Cursor CLI
curl https://cursor.com/install -fsS | bash

# Atur kunci API untuk skrip  
export CURSOR_API_KEY=your_api_key_here
cursor-agent -p "Analisis kode ini"

Contoh skrip

Gunakan format output yang berbeda untuk kebutuhan skrip yang berbeda. Lihat Format output untuk detailnya.

Menelusuri codebase

Gunakan --output-format text untuk respons yang mudah dibaca:
#!/bin/bash
# Pertanyaan kodebase sederhana

cursor-agent -p --output-format text "Apa yang dilakukan kodebase ini?"

Tinjauan kode otomatis

Pakai --output-format json buat analisis terstruktur:
#!/bin/bash
# simple-code-review.sh - Skrip peninjauan kode dasar

echo "Memulai peninjauan kode..."

# Meninjau perubahan terbaru
cursor-agent -p --force --output-format text \
  "Tinjau perubahan kode terbaru dan berikan feedback tentang:
  - Kualitas dan keterbacaan kode  
  - Potensi bug atau masalah
  - Pertimbangan keamanan
  - Kepatuhan terhadap praktik terbaik

  Berikan saran spesifik untuk perbaikan dan tulis ke review.txt"

if [ $? -eq 0 ]; then
  echo "✅ Peninjauan kode berhasil diselesaikan"
else
  echo "❌ Peninjauan kode gagal"
  exit 1
fi

Pelacakan progres waktu nyata

Gunakan --output-format stream-json untuk melacak progres secara waktu nyata:
#!/bin/bash
# stream-progress.sh - Lacak progres secara real-time

echo "🚀 Memulai pemrosesan stream..."

# Lacak progres secara real-time
accumulated_text=""
tool_count=0
start_time=$(date +%s)

cursor-agent -p --force --output-format stream-json \
  "Analisis struktur proyek ini dan buat ringkasan di 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 "🤖 Memakai model: $model"
        fi
        ;;
        
      "assistant")
        # Akumulasi delta teks streaming
        content=$(echo "$line" | jq -r '.message.content[0].text // empty')
        accumulated_text="$accumulated_text$content"
        
        # Tampilkan progres secara langsung
        printf "\r📝 Menghasilkan: %d karakter" ${#accumulated_text}
        ;;
        
      "tool_call")
        if [ "$subtype" = "started" ]; then
          tool_count=$((tool_count + 1))
          
          # Ekstrak informasi alat
          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🔧 Alat #$tool_count: Membuat $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📖 Alat #$tool_count: Membaca $path"
          fi
          
        elif [ "$subtype" = "completed" ]; then
          # Ekstrak dan tampilkan hasil alat
          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 "   ✅ Membuat $lines baris ($size byte)"
          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 "   ✅ Membaca $lines baris"
          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🎯 Selesai dalam ${duration}ms (${total_time}s total)"
        echo "📊 Statistik akhir: $tool_count alat, ${#accumulated_text} karakter dihasilkan"
        ;;
    esac
  done
I