Zum Hauptinhalt springen
Verwende die Cursor-CLI in Skripten und Automatisierungs-Workflows für Codeanalyse, -generierung und Refactoring.

So funktioniert’s

Verwende den Print-Modus (-p, --print) für nicht-interaktives Scripting und Automatisierung.

Dateiänderungen in Skripten

Kombiniere --print mit --force, um Dateien in Skripten zu ändern:
# Dateiänderungen im Print-Modus aktivieren
cursor-agent -p --force "Refactor this code to use modern ES6+ syntax"

# Ohne --force werden Änderungen nur vorgeschlagen, nicht übernommen
cursor-agent -p "Füge JSDoc-Kommentare zu dieser Datei hinzu"  # Dateien werden nicht geändert

# Stapelverarbeitung mit tatsächlichen Dateiänderungen
find src/ -name "*.js" | while read file; do
  cursor-agent -p --force "Füge ausführliche JSDoc-Kommentare zu $file hinzu"
done
Das Flag --force erlaubt dem Agenten, direkte Dateiänderungen ohne Bestätigung vorzunehmen

Einrichtung

Sieh dir Installation und Authentifizierung für alle Details zur Einrichtung an.
# Cursor-CLI installieren
curl https://cursor.com/install -fsS | bash

# API-Schlüssel für Skripte festlegen  
export CURSOR_API_KEY=your_api_key_here
cursor-agent -p "Diesen Code analysieren"

Beispielskripte

Verwende je nach Bedarf unterschiedliche Ausgabeformate. Sieh dir Ausgabeformat für Details an.

Codebase durchsuchen

Verwende --output-format text für gut lesbare Antworten:
#!/bin/bash
# Einfache Frage zur Codebase

cursor-agent -p --output-format text "Wozu dient diese Codebase?"

Automatisiertes Code-Review

Verwende --output-format json für eine strukturierte Analyse:
#!/bin/bash
# simple-code-review.sh - Einfaches Code-Review-Skript

echo "Code-Review wird gestartet..."

# Kürzlich vorgenommene Änderungen prüfen
cursor-agent -p --force --output-format text \
  "Prüfe die jüngsten Code-Änderungen und gib Feedback zu:
  - Codequalität und Lesbarkeit  
  - möglichen Bugs oder Problemen
  - Sicherheitsaspekten
  - Einhaltung von Best Practices

  Mach konkrete Verbesserungsvorschläge und schreibe sie in review.txt"

if [ $? -eq 0 ]; then
  echo "✅ Code-Review erfolgreich abgeschlossen"
else
  echo "❌ Code-Review fehlgeschlagen"
  exit 1
fi

Fortschritt in Echtzeit verfolgen

Verwende --output-format stream-json, um den Fortschritt in Echtzeit zu verfolgen:
#!/bin/bash
# stream-progress.sh - Fortschritt in Echtzeit verfolgen

echo "🚀 Starte Stream-Verarbeitung ..."

# Fortschritt in Echtzeit verfolgen
accumulated_text=""
tool_count=0
start_time=$(date +%s)

cursor-agent -p --force --output-format stream-json \
  "Analysiere diese Projektstruktur und erstelle eine Zusammenfassung 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 "🤖 Verwendetes Modell: $model"
        fi
        ;;
        
      "assistant")
        # Streaming-Text-Deltas sammeln
        content=$(echo "$line" | jq -r '.message.content[0].text // empty')
        accumulated_text="$accumulated_text$content"
        
        # Live-Fortschritt anzeigen
        printf "\r📝 Generiere: %d Zeichen" ${#accumulated_text}
        ;;
        
      "tool_call")
        if [ "$subtype" = "started" ]; then
          tool_count=$((tool_count + 1))
          
          # Tool-Informationen erfassen
          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: Erstelle $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: Lese $path"
          fi
          
        elif [ "$subtype" = "completed" ]; then
          # Tool-Ergebnisse extrahieren und anzeigen
          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 "   ✅ Erstellt: $lines Zeilen ($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 "   ✅ Gelesen: $lines Zeilen"
          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🎯 Abgeschlossen in ${duration} ms (${total_time} s insgesamt)"
        echo "📊 Endstatistik: $tool_count Tools, ${#accumulated_text} Zeichen generiert"
        ;;
    esac
  done
I