Saltar al contenido principal
Usa la CLI de Cursor en scripts y flujos de automatización para tareas de análisis, generación y refactorización de código.

Cómo funciona

Usa print mode (-p, --print) para scripting y automatización no interactivos.

Modificación de archivos en scripts

Combina --print con --force para modificar archivos desde scripts:
# Habilita modificaciones de archivos en modo de impresión
cursor-agent -p --force "Refactoriza este código para usar sintaxis moderna de ES6+"

# Sin --force, los cambios solo se proponen; no se aplican
cursor-agent -p "Añade comentarios JSDoc a este archivo"  # No modificará archivos

# Procesamiento por lotes con cambios reales en archivos
find src/ -name "*.js" | while read file; do
  cursor-agent -p --force "Añade comentarios JSDoc detallados a $file"
done
La opción --force permite que el agente haga cambios directos en archivos sin pedir confirmación

Configuración

Consulta Instalación y Autenticación para ver todos los detalles de configuración.
# Instalar la CLI de Cursor
curl https://cursor.com/install -fsS | bash

# Configurar la clave de API para scripts  
export CURSOR_API_KEY=tu_api_key_aquí
cursor-agent -p "Analiza este código"

Scripts de ejemplo

Usa distintos formatos de salida según las necesidades de cada script. Consulta Formato de salida para más detalles.

Búsqueda en el código

Usa --output-format text para respuestas legibles:
#!/bin/bash
# Pregunta simple sobre el código

cursor-agent -p --output-format text "¿Qué hace este código?"

Revisión automática de código

Usa --output-format json para obtener un análisis estructurado:
#!/bin/bash
# simple-code-review.sh - Script básico de revisión de código

echo "Iniciando la revisión de código..."

# Revisar cambios recientes
cursor-agent -p --force --output-format text \
  "Revisa los cambios de código recientes y da feedback sobre:
  - Calidad y legibilidad del código  
  - Posibles errores o problemas
  - Consideraciones de seguridad
  - Cumplimiento de buenas prácticas

  Ofrece sugerencias específicas de mejora y escribe en review.txt"

if [ $? -eq 0 ]; then
  echo "✅ Revisión de código completada correctamente"
else
  echo "❌ Error en la revisión de código"
  exit 1
fi

Seguimiento del progreso en tiempo real

Usa --output-format stream-json para hacer seguimiento del progreso en tiempo real:
#!/bin/bash
# stream-progress.sh - Seguimiento del progreso en tiempo real

echo "🚀 Iniciando el procesamiento del stream..."

# Seguimiento del progreso en tiempo real
accumulated_text=""
tool_count=0
start_time=$(date +%s)

cursor-agent -p --force --output-format stream-json \
  "Analiza esta estructura del proyecto y crea un informe de resumen en 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 "🤖 Usando el modelo: $model"
        fi
        ;;
        
      "assistant")
        # Acumular deltas de texto en streaming
        content=$(echo "$line" | jq -r '.message.content[0].text // empty')
        accumulated_text="$accumulated_text$content"
        
        # Mostrar progreso en tiempo real
        printf "\r📝 Generando: %d caracteres" ${#accumulated_text}
        ;;
        
      "tool_call")
        if [ "$subtype" = "started" ]; then
          tool_count=$((tool_count + 1))
          
          # Extraer información de la herramienta
          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🔧 Herramienta #$tool_count: creando $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📖 Herramienta #$tool_count: leyendo $path"
          fi
          
        elif [ "$subtype" = "completed" ]; then
          # Extraer y mostrar los resultados de la herramienta
          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 "   ✅ Se crearon $lines líneas ($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 "   ✅ Se leyeron $lines líneas"
          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🎯 Completado en ${duration} ms (${total_time} s en total)"
        echo "📊 Estadísticas finales: $tool_count herramientas, ${#accumulated_text} caracteres generados"
        ;;
    esac
  done
I