Usa o Cursor CLI em scripts e fluxos de automação para tarefas de análise de código, geração e refatoração.
Usa o modo de impressão (-p, --print) para scripts e automação não interativos.
Modificação de arquivos em scripts
Combina --print com --force para modificar arquivos em scripts:
# Habilitar modificações de arquivos no modo de impressão
cursor-agent -p --force "Refatora este código para usar a sintaxe moderna ES6+"
# Sem --force, as alterações são apenas propostas, não aplicadas
cursor-agent -p "Adicionar comentários JSDoc a este arquivo" # Não modifica arquivos
# Processamento em lote com alterações reais nos arquivos
find src/ -name "*.js" | while read file; do
cursor-agent -p --force "Adicionar comentários JSDoc completos a $file"
done
A flag --force permite que o agente faça alterações diretamente nos arquivos sem pedir confirmação
Veja Instalação e Autenticação para obter detalhes completos da configuração.
# Instalar a CLI do Cursor
curl https://cursor.com/install -fsS | bash
# Definir a chave de API para scripts
export CURSOR_API_KEY=sua_chave_de_api_aqui
cursor-agent -p "Analisa este código"
Usa formatos de saída diferentes conforme a necessidade de cada script. Vê Formato de saída para detalhes.
Usa --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 automática de código
Usa --output-format json para obter uma análise estruturada:
#!/bin/bash
# simple-code-review.sh - Script básico de revisão de código
echo "Iniciando a revisão de código..."
# Revisar alterações recentes
cursor-agent -p --force --output-format text \
"Analisa as alterações recentes no código e fornece feedback sobre:
- Qualidade e legibilidade do código
- Possíveis bugs ou problemas
- Considerações de segurança
- Conformidade com boas práticas
Fornece sugestões específicas de melhoria e grava em review.txt"
if [ $? -eq 0 ]; then
echo "✅ Revisão de código concluída com sucesso"
else
echo "❌ Falha na revisão de código"
exit 1
fi
Acompanhamento do progresso em tempo real
Usa --output-format stream-json para acompanhar o progresso em tempo real:
#!/bin/bash
# stream-progress.sh - Acompanhar o progresso em tempo real
echo "🚀 Iniciando o processamento do stream..."
# Acompanhar o progresso em tempo real
accumulated_text=""
tool_count=0
start_time=$(date +%s)
cursor-agent -p --force --output-format stream-json \
"Analisa a estrutura deste projeto e cria 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 o modelo: $model"
fi
;;
"assistant")
# Acumular deltas de texto do stream
content=$(echo "$line" | jq -r '.message.content[0].text // empty')
accumulated_text="$accumulated_text$content"
# Mostrar progresso em tempo real
printf "\r📝 Gerando: %d chars" ${#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 no total)"
echo "📊 Estatísticas finais: $tool_count ferramentas, ${#accumulated_text} chars gerados"
;;
esac
done