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.
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
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"
Usa distintos formatos de salida según las necesidades de cada script. Consulta Formato de salida para más detalles.
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