Cursor

Cursor é um editor de código alimentado por IA, construído sobre o VS Code, que integra recursos avançados de IA para geração, edição e depuração de código, com suporte para múltiplos modelos de IA, incluindo GPT-4 e Claude.

Instalação e Configuração

Comando	Descrição
Download from cursor.sh	Instale o Cursor do site oficial
cursor --version	Verificar versão instalada
cursor .	Abrir diretório atual no Cursor
cursor file.py	Abrir arquivo específico
cursor --help	Exibir informações de ajuda
cursor --extensions-dir	Mostrar diretório de extensões

Recursos Básicos de IA

Atalho	Descrição
Ctrl+K / Cmd+K	Paleta de comandos do Open AI
Ctrl+L / Cmd+L	Painel de chat Open AI
Ctrl+I / Cmd+I	Edição de IA em linha
Tab	Aceitar sugestão de IA
Escape	Rejeitar sugestão de IA
Alt+] / Option+]	Próxima sugestão de IA
Alt+[ / Option+[	Sugestão anterior de IA

Comandos de Chat de IA

Comando	Descrição
@workspace	Referenciar todo o workspace
@file	Referenciar ficheiro específico
@folder	Conteúdo da pasta de referência
@code	Referenciar código selecionado
@docs	Documentação de referência
@web	Pesquisar na web por contexto
@git	Histórico de referência do git

Geração de Código

Geração Inline

Atalho	Descrição
Ctrl+K then type prompt	Gerar código inline
Ctrl+K then Ctrl+A	Gerar arquivo completo
Ctrl+K then Ctrl+D	Gerar documentação
Ctrl+K then Ctrl+T	Gerar testes
Ctrl+K then Ctrl+R	Refatorar código
Ctrl+K then Ctrl+F	Corrigir problemas de código

Geração Baseada em Chat

Comando	Descrição
”Create a function that…”	Gerar função específica
”Add error handling to this code”	Melhorar código existente
”Convert this to TypeScript”	Conversão de idioma
”Optimize this algorithm”	Otimização de desempenho
”Add comments to explain this”	Geração de documentação

Edição de Código

Edição Baseada em Seleção

Atalho	Descrição
Select code + Ctrl+K	Editar código selecionado
Select code + Ctrl+I	Seleção de edição inline
Ctrl+Shift+K	Editar com contexto
Alt+K	Edição rápida

Edição Multi-cursor

Atalho	Descrição
Ctrl+Alt+Down / Cmd+Option+Down	Adicionar cursor abaixo
Ctrl+Alt+Up / Cmd+Option+Up	Adicionar cursor acima
Ctrl+D / Cmd+D	Selecionar próxima ocorrência
Ctrl+Shift+L / Cmd+Shift+L	Selecionar todas as ocorrências

Configuração de Modelos de IA

Configuração	Descrição
GPT-4	Modelo padrão para tarefas complexas
GPT-3.5-turbo	Modelo mais rápido para tarefas simples
Claude-3	Modelo alternativo para codificação
Codex	Especializado para geração de código
Custom models	Configurar modelos locais ou personalizados

Recursos do Workspace

Gerenciamento de Arquivos

Atalho	Descrição
Ctrl+P / Cmd+P	Abertura rápida de arquivo
Ctrl+Shift+P / Cmd+Shift+P	Paleta de comandos
Ctrl+Shift+E / Cmd+Shift+E	Painel do Explorer
Ctrl+Shift+F / Cmd+Shift+F	Pesquisar em arquivos
Ctrl+Shift+G / Cmd+Shift+G	Controle de versão

Busca Aprimorada por IA

Comando	Descrição
@search "semantic query"	Busca semântica de código
@find "natural language"	Localização de arquivos de linguagem natural
@grep "pattern with AI"	grep aprimorado por IA

Depuração com IA

Recurso	Descrição
AI Debug Assistant	Explicar saída de debugging
Error Explanation	IA explica mensagens de erro
Fix Suggestions	IA sugere correções para bugs
Breakpoint Analysis	IA analisa contexto de breakpoint

Comandos de Depuração

Atalho	Descrição
F5	Iniciar depuração
F9	Alternar ponto de interrupção
F10	Passar por cima
F11	Entre em
Shift+F11	Saia
Ctrl+Shift+F5	Reiniciar depuração

Integração com Git

Comando	Descrição
@git diff	IA explica diferenças do git
@git commit	Gerar mensagens de commit
@git branch	Sugerir nomes de branches
@git merge	Ajuda com conflitos de merge

Atalhos do Git

Atalho	Descrição
Ctrl+Shift+G / Cmd+Shift+G	Painel de controle de source control
Ctrl+Enter / Cmd+Enter	Confirmar alterações
Ctrl+Shift+P then “Git”`	Comandos Git

Extensões e Personalização

Extensões Populares

Extensão	Descrição
Cursor AI	Funcionalidade principal de IA
GitHub Copilot	Assistência adicional de IA
Prettier	Formatação de código
ESLint	Linting de JavaScript
Python	Suporte à linguagem Python
Live Share	Colaboração em tempo real

Configuração de Definições

Configuração	Descrição
cursor.ai.model	Modelo de IA padrão
cursor.ai.temperature	Nível de criatividade de IA
cursor.ai.maxTokens	Comprimento máximo de resposta
cursor.ai.autoComplete	Ativar autocompletar
cursor.ai.inlineChat	Ativar chat em linha

Recursos Avançados

Modo Compositor

Recurso	Descrição
Multi-file editing	Editar vários arquivos simultaneamente
Project-wide changes	Aplicar alterações em todo o projeto
Dependency tracking	Rastrear dependências de arquivos
Batch operations	Realizar operações em massa

Agentes de IA

Agente	Descrição
Code Agent	Especializado para tarefas de código
Debug Agent	Focado na depuração
Test Agent	Gera e executa testes
Docs Agent	Cria documentação
Refactor Agent	Especialista em refatoração de código

Recursos Específicos de Linguagem

Python

Would you like me to continue with the remaining sections or provide placeholders for the empty sections?

Comando	Descrição
@python "create class"	Gerar classes Python
@python "add type hints"	Adicionar anotações de tipo
@python "create tests"	Gerar testes pytest
@python "optimize"	Otimização de desempenho

Comando	Descrição
@js "create component"	Gerar componentes React
@ts "add types"	Adicionar tipos TypeScript
@js "async/await"	Converter para async/await
@js "error handling"	Adicionar tratamento de erros

Comando	Descrição
@rust "safe code"	Gerar código Rust seguro
@go "concurrent"	Padrões de concorrência em Go
@java "spring boot"	Aplicações Spring Boot
@cpp "modern cpp"	Recursos modernos de C++

Modelo	Descrição
@template api	Modelo de REST API
@template component	Modelo de componente de UI
@template test	Modelo de arquivo de teste
@template config	Modelo de configuração

Recurso	Descrição
Auto-save	Salvamento automático de arquivo
Format on save	Formatar código automaticamente
Lint on save	Auto-lint código
AI suggestions	Sugestões proativas

Recurso	Descrição
Live Share	Colaboração em tempo real
AI Pair Programming	IA como parceiro de programação
Code Reviews	Revisões assistidas por IA
Team Settings	Configurações de AI compartilhadas

Atalho	Descrição
Ctrl+Shift+P then “Live Share”`	Iniciar sessão de colaboração
Ctrl+Shift+P then “Share”`	Compartilhar workspace

Configuração	Descrição
cursor.ai.cacheSize	Tamanho do cache de resposta de IA
cursor.ai.requestTimeout	Tempo limite de solicitação
cursor.ai.batchSize	Tamanho do lote de solicitações
cursor.ai.throttle	Limitação de solicitações

Problema	Solução
AI not responding	Verificar conexão com a internet
Slow responses	Reduzir tamanho do contexto
Wrong suggestions	Forneça mais contexto
Model errors	Alternar modelo de IA
Extension conflicts	Desativar extensões conflitantes

Comando	Descrição
Ctrl+Shift+P then “Developer: Reload Window”`	Recarregar Cursor
Ctrl+Shift+P then “Developer: Toggle Developer Tools”`	Abra as ferramentas de desenvolvedor
Help > Show All Commands	Mostrar todos os comandos disponíveis

{
  "cursor.ai.customModels": [
    {
      "name": "Local Model",
      "endpoint": "http://localhost:8000",
      "apiKey": "your-api-key"
    }
  ]
}
```## Integração de API

### Modelos Personalizados
```json
{
  "cursor.ai.webhooks": {
    "onCodeGeneration": "https://your-webhook.com/code",
    "onError": "https://your-webhook.com/error"
  }
}
```### Configuração de Webhook

| Atalho | Ação |
|---------|-------------|
| `Ctrl+K` | Comando de IA |
| `Ctrl+L` | Chat de IA |
| `Ctrl+I` | Edição inline |
| `Tab` | Aceitar sugestão |
| `Escape` | Rejeitar sugestão |
| `Ctrl+/` | Alternar comentário |
| `Ctrl+S` | Salvar arquivo |
| `Ctrl+Z` | Desfazer |
| `Ctrl+Y` | Refazer |## Resumo de Atalhos de Teclado

### Atalhos Essenciais

| Atalho | Ação |
|---------|-------------|
| `Ctrl+P` | Abertura Rápida |
| `Ctrl+G` | Ir para linha |
| `Ctrl+F` | Encontrar |
| `Ctrl+H` | Substituir |
| `F12` | Ir para definição |
| `Alt+F12` | Definição de Peek |### Navegação
```yaml
# GitHub Actions with Cursor
name: AI Code Review
on: [pull_request]
jobs:
  ai-review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: AI Code Review
        run: cursor-cli review --pr ${{ github.event.number }}
```## Melhores Práticas

### Prompting Eficaz
- Seja específico e claro nas solicitações
- Forneça contexto para melhores resultados
- Use exemplos sempre que possível
- Divida tarefas complexas em partes menores
- Itere e refine os prompts

### Qualidade de Código
- Revise o código gerado por IA cuidadosamente
- Adicione tratamento de erros adequado
- Inclua testes abrangentes
- Siga padrões de codificação
- Documente a lógica complexa

### Desempenho
- Use modelos de IA apropriados para tarefas
- Otimize o tamanho do contexto
- Faça cache de respostas frequentemente usadas
- Monitore o uso de API
- Configure timeouts adequadamente

### Segurança
- Revise sugestões de IA em busca de problemas de segurança
- Não inclua dados sensíveis em prompts
- Use endpoints de API seguros
- Implemente controles de acesso adequados
- Faça auditorias de segurança regulares

## Exemplos de Integração

### Integração CI/CD
```bash
#!/bin/bash
# Cursor automation script
cursor --ai-command "review and optimize" src/
cursor --ai-command "generate tests" src/
cursor --ai-command "update documentation" docs/
```### Scripts Personalizados

### Casos de Uso Comuns

### Desenvolvimento Web
- Geração de componentes React
- Criação de endpoints de API
- Design de esquema de banco de dados
- Otimização de frontend
- Automação de testes

### Ciência de Dados
- Scripts de análise de dados
- Modelos de aprendizado de máquina
- Código de visualização
- Pipelines de limpeza de dados
- Análise estatística

### DevOps
- Infraestrutura como código
- Configuração de pipeline CI/CD
- Configuração de monitoramento
- Scripts de implantação
- Configurações de segurança