Use o Cursor CLI em scripts e workflows de automação para tarefas de análise, geração e refatoração de código.

​
Como funciona

Use o modo de impressão (-p, --print) para scripts não interativos e automação.

​
Modificação de arquivos em scripts

Combine --print com --force para modificar arquivos em scripts: 
# Habilita modificações de arquivos no modo de impressão
cursor-agent -p --force "Refatore este código para usar sintaxe ES6+ moderna"

# Sem --force, as mudanças são apenas propostas, não aplicadas
cursor-agent -p "Adicione comentários JSDoc a este arquivo"  # Não vai modificar arquivos

# Processamento em lote com mudanças reais nos arquivos
find src/ -name "*.js" | while read file; do
  cursor-agent -p --force "Adicione comentários JSDoc abrangentes ao $file"
done
A flag --force permite que o agente faça mudanças diretas nos arquivos sem confirmação

​
Configuração

Consulte Instalação e Autenticação para detalhes completos da configuração. 
# Install Cursor CLI
curl https://cursor.com/install -fsS | bash

# Set API key for scripts  
export CURSOR_API_KEY=your_api_key_here
cursor-agent -p "Analyze this code"

​
Scripts de exemplo

Use diferentes formatos de saída para diferentes necessidades de script. Veja Formato de saída para detalhes.

​
Pesquisando o codebase

Use --output-format text para respostas legíveis: 
#!/bin/bash
# Pergunta simples sobre o codebase

cursor-agent -p --output-format text "O que esse codebase faz?"

​
Revisão automatizada de código

Use --output-format json para análise estruturada: 
#!/bin/bash
# simple-code-review.sh - Script básico de revisão de código

echo "Iniciando revisão de código..."

# Revisar mudanças recentes
cursor-agent -p --force --output-format text \
  "Revise as mudanças recentes no código e forneça feedback sobre:
  - Qualidade e legibilidade do código  
  - Possíveis bugs ou problemas
  - Considerações de segurança
  - Conformidade com boas práticas

  Forneça sugestões específicas para melhoria e escreva em review.txt"

if [ $? -eq 0 ]; then
  echo "✅ Revisão de código concluída com sucesso"
else
  echo "❌ Revisão de código falhou"
  exit 1
fi

​
Acompanhamento de progresso em tempo real

Use --output-format stream-json para acompanhamento de progresso em tempo real: 
#!/bin/bash
# stream-progress.sh - Acompanhar progresso em tempo real

echo "🚀 Iniciando processamento de stream..."

# Acompanhar progresso em tempo real
accumulated_text=""
tool_count=0
start_time=$(date +%s)

cursor-agent -p --force --output-format stream-json \
  "Analise esta estrutura de projeto e crie um relatório resumido em 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 modelo: $model"
        fi
        ;;
        
      "assistant")
        # Acumular deltas de texto em streaming
        content=$(echo "$line" | jq -r '.message.content[0].text // empty')
        accumulated_text="$accumulated_text$content"
        
        # Mostrar progresso ao vivo
        printf "\r📝 Gerando: %d caracteres" ${#accumulated_text}
        ;;
        
      "tool_call")
        if [ "$subtype" = "started" ]; then
          tool_count=$((tool_count + 1))
          
          # Extrair informações da ferramenta
          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🔧 Ferramenta #$tool_count: Criando $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📖 Ferramenta #$tool_count: Lendo $path"
          fi
          
        elif [ "$subtype" = "completed" ]; then
          # Extrair e mostrar resultados da ferramenta
          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 "   ✅ Criadas $lines linhas ($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 "   ✅ Lidas $lines linhas"
          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🎯 Concluído em ${duration}ms (${total_time}s total)"
        echo "📊 Estatísticas finais: $tool_count ferramentas, ${#accumulated_text} caracteres gerados"
        ;;
    esac
  done