Guia AIOX para Cursor

🌐 EN | PT | ES

Editor de Código AI-First - IDE com IA Mais Popular

Visão Geral

O que é o Cursor?

Cursor é um editor de código AI-first construído sobre o VS Code, projetado para tornar desenvolvedores mais produtivos com assistência de IA integrada. Ele combina recursos familiares do VS Code com poderosas capacidades de IA incluindo geração de código, edição e conversação.

Por que usar AIOX com Cursor?

O Cursor é uma das IDEs com IA mais populares com excelente integração AIOX:

Grande Base de Usuários: Comunidade ativa e atualizações contínuas
Ativação @mention: Ativação natural de agentes com sintaxe @
Integração Composer: Edição multi-arquivo com assistência IA
Contexto @codebase: Entendimento completo do projeto
Suporte MCP: Extensível via configuração
Compatibilidade VS Code: Funciona com extensões do VS Code

Comparação com Outras Plataformas

| -------------------- | :----: | :---------: | :------: | | Interface GUI | Sim | Não | Sim | | Ativação @mention | Sim | /comando | Sim | | Composer | Sim | Task Tool | Cascade | | Extensões VS Code | Sim | Não | Limitado | | Suporte MCP | Config | Nativo | Config | | Edição Multi-arquivo | Sim | Sim | Sim |

Requisitos

Requisitos de Sistema

Requisito	Mínimo	Recomendado
RAM	4GB	8GB+
Espaço em Disco	500MB	1GB+
SO	macOS 10.15+, Windows 10+, Linux	Última versão
Node.js	18.0+ (para AIOX)	20.0+

Requisitos de Conta

Conta Cursor (tier gratuito disponível)
Chaves de API (opcional): OpenAI, Anthropic, ou use modelos nativos do Cursor

Configuração Recomendada

Git instalado e configurado
GitHub CLI (gh) para operações de PR
Assinatura Cursor Pro para recursos avançados

Instalação

Passo 1: Instalar o Cursor

Baixe em cursor.com
Execute o instalador para sua plataforma
Inicie o Cursor e faça login

# macOS (via Homebrew)
brew install --cask cursor

# Ou baixe diretamente de cursor.com

Passo 2: Configurar as Configurações do Cursor

Abra Configurações do Cursor (Cmd/Ctrl + ,):

AI Settings > Habilitar recursos de IA
Models > Selecionar modelo preferido (Claude, GPT-4, etc.)
Rules > Habilitar regras personalizadas

Passo 3: Instalar o AIOX

# Navegue até seu projeto
cd seu-projeto

# Inicialize o AIOX
npx @anthropic/aiox init

# Selecione "Cursor" quando solicitado para IDE

Passo 4: Verificar a Instalação

Verifique se os arquivos AIOX foram criados:

ls -la .cursor/

Estrutura esperada:

.cursor/
├── rules.md           # Configuração principal de regras
├── rules/             # Pasta de regras de agentes
│   ├── dev.md
│   ├── qa.md
│   ├── architect.md
│   └── ...
└── settings.json      # Configurações locais do Cursor

Configuração

Arquivo de Regras Principal

Localização: .cursor/rules.md

Este arquivo contém:

Regras e contexto específicos do projeto
Instruções de ativação de agentes
Padrões de desenvolvimento
Integração do framework AIOX

Pasta de Regras de Agentes

Localização: .cursor/rules/

Cada agente tem um arquivo dedicado:

.cursor/rules/
├── dev.md          # Regras do agente desenvolvedor
├── qa.md           # Regras do agente QA
├── architect.md    # Regras do agente arquiteto
├── pm.md           # Regras do gerente de projeto
├── po.md           # Regras do product owner
├── sm.md           # Regras do scrum master
├── analyst.md      # Regras do analista de negócios
└── devops.md       # Regras do agente DevOps

Configurações do Cursor

Localização: .cursor/settings.json

{
  "cursor.ai.enabled": true,
  "cursor.ai.model": "claude-3-5-sonnet",
  "cursor.rules.enabled": true,
  "cursor.rules.path": ".cursor/rules.md"
}

Configuração MCP

Localização: ~/.cursor/mcp.json ou projeto .cursor/mcp.json

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
    }
  }
}

Uso Básico

Iniciando o Cursor com AIOX

Abra seu projeto no Cursor
As regras em .cursor/rules.md são carregadas automaticamente
Use o painel de chat IA (Cmd/Ctrl + L)

Ativando Agentes AIOX

Agentes são ativados usando @mentions no chat:

@dev         # Agente desenvolvedor
@qa          # Agente engenheiro de QA
@architect   # Agente arquiteto de software
@pm          # Agente gerente de projeto
@po          # Agente product owner
@sm          # Agente scrum master
@analyst     # Agente analista de negócios
@devops      # Agente engenheiro DevOps

Exemplos de Ativação de Agentes

@dev implemente a feature de autenticação seguindo a story

@qa revise este código para vulnerabilidades de segurança

@architect projete a arquitetura de microserviços para o sistema de pagamento

@pm crie um plano de sprint para as próximas duas semanas

Usando o Composer

O Composer do Cursor permite edição multi-arquivo:

Abra o Composer (Cmd/Ctrl + I)
Descreva suas alterações
Selecione arquivos para modificar
Revise e aplique alterações

# Exemplo de prompt do Composer
@dev Crie um novo endpoint REST API para registro de usuário.
Inclua:
- Handler de rota em src/routes/
- Middleware de validação
- Lógica da camada de serviço
- Testes unitários

Usando @codebase

Referencie o contexto completo do seu projeto:

@codebase Como a autenticação está atualmente implementada?

@codebase @dev Refatore as queries do banco de dados para usar o padrão repository

Uso Avançado

Fluxos de Trabalho do Composer

Refatoração Multi-Arquivo

@architect @codebase
Refatore o módulo de usuário para seguir clean architecture:
1. Extrair interfaces
2. Criar camada de repositório
3. Atualizar serviços
4. Manter testes

Implementação de Feature

@dev @codebase
Implemente a feature de carrinho de compras:
- Modelo e migrations do carrinho
- Operações CRUD
- Persistência de sessão
- Endpoints de API

Modos de Chat

O Cursor suporta diferentes modos de interação:

Modo	Caso de Uso
Chat	Perguntas gerais, explicações
Edit	Modificações inline de código
Composer	Alterações multi-arquivo
Terminal	Execução de comandos

Edição Inline

Selecione código e use Cmd/Ctrl + K:

# Selecione código, então:
@dev otimize esta função para performance
@qa adicione tratamento de erros a este bloco

Organização de Regras

Organize regras por contexto:

.cursor/
├── rules.md              # Regras globais
└── rules/
    ├── agents/           # Regras específicas de agentes
    │   ├── dev.md
    │   └── qa.md
    ├── patterns/         # Padrões de código
    │   ├── api.md
    │   └── testing.md
    └── project/          # Específico do projeto
        └── conventions.md

Recursos Específicos do Cursor

Superpoderes

Recurso	Descrição
Cmd+K	Edição IA inline
Cmd+L	Abrir chat IA
Cmd+I	Abrir Composer
Cmd+Shift+L	Adicionar seleção ao chat
Tab	Aceitar sugestão IA

Atalhos de Teclado

Atalho	Ação
`Cmd/Ctrl + K`	Edição IA
`Cmd/Ctrl + L`	Chat IA
`Cmd/Ctrl + I`	Composer
`Cmd/Ctrl + Shift + K`	Editar com seleção
`Escape`	Cancelar operação IA

Referências de Contexto

Use estas no chat ou Composer:

Referência	Descrição
`@codebase`	Contexto completo do projeto
`@file`	Arquivo específico
`@folder`	Conteúdo da pasta
`@docs`	Documentação
`@web`	Busca web
`@nome-agente`	Agente AIOX

Seleção de Modelo

Mude de modelo baseado na tarefa:

Modelo	Melhor Para
Claude 3.5 Sonnet	Raciocínio complexo, arquitetura
GPT-4	Codificação geral
GPT-4 Turbo	Respostas rápidas
Cursor Small	Completações rápidas

Sincronização de Agentes

Como Funciona

flowchart LR
    Source["AIOX Core<br/>.aiox-core/development/agents"] --> Parser["Parser de Agente"]
    Parser --> Transform["Transformador Cursor"]
    Transform --> Output[".cursor/rules/"]

Comandos de Sincronização

# Sincronizar todos os agentes
npm run sync:ide

# Sincronizar agente específico
npm run sync:ide

# Forçar ressincronização
npm run sync:ide

Formato de Arquivo de Agente

Agentes no Cursor usam formato markdown condensado:

# Agente Desenvolvedor (@dev)

## Papel

Desenvolvedor Full Stack Sênior focado em código limpo e manutenível.

## Expertise

- TypeScript/JavaScript
- Node.js/React
- Design de banco de dados
- Desenvolvimento de API

## Fluxo de Trabalho

1. Entender requisitos da story
2. Planejar abordagem de implementação
3. Escrever código limpo e testado
4. Atualizar progresso da story

## Padrões

- Seguir convenções existentes do codebase
- Escrever tratamento abrangente de erros
- Incluir testes unitários para código novo

Resolução de Conflitos

Quando conflitos ocorrem durante o sync:

Backup criado em .cursor/rules/.backup/
Prompt para estratégia de resolução
Opções: manter local, usar remoto, mesclar

Limitações Conhecidas

Limitações Atuais

Limitação	Solução Alternativa
Sem MCP nativo	Use MCP baseado em configuração
Sem spawn de subagente	Troca manual de agente
Limites de janela de contexto	Use @codebase seletivamente
Rate limiting	Configure nas configurações

Cursor vs Claude Code

Aspecto	Cursor	Claude Code
Task Tool	Não	Sim
Hooks	Não	Sim
Skills	Não	Nativo
GUI	Sim	Não
Ext VS Code	Sim	Não

Problemas Conhecidos

Projetos grandes podem deixar @codebase lento
Algumas extensões VS Code podem conflitar
MCP requer configuração manual

Troubleshooting

Problemas Comuns

Regras Não Carregando

Problema: Agente não responde a @mentions

Solução:

Verifique se arquivo de regras existe: ls .cursor/rules.md
Confira Cursor settings > Rules > Enabled
Reinicie o Cursor

MCP Não Funcionando

Problema: Ferramentas MCP não disponíveis

Solução:

# Verificar configuração MCP
cat ~/.cursor/mcp.json

# Verificar se servidor MCP está instalado
npx @modelcontextprotocol/server-filesystem --version

Performance Lenta

Problema: Cursor está lento com projetos grandes

Solução:

Exclua pastas grandes em .cursorignore
Use referências específicas de arquivo ao invés de @codebase
Aumente alocação de memória nas configurações

Agente Não Reconhecido

Problema: @dev não ativa agente

Solução:

# Ressincronizar agentes
npm run sync:ide

# Verificar se arquivo do agente existe
ls .cursor/rules/dev.md

Logs e Diagnósticos

# Localização dos logs do Cursor
# macOS: ~/Library/Application Support/Cursor/logs/
# Windows: %APPDATA%\Cursor\logs\
# Linux: ~/.config/Cursor/logs/

# Ver log mais recente
tail -f ~/Library/Application\ Support/Cursor/logs/main.log

Resetar Configuração

# Backup da configuração atual
cp -r .cursor/ .cursor-backup/

# Reinicializar AIOX
npx @anthropic/aiox init --ide cursor --force

FAQ

Perguntas Gerais

P: O Cursor é gratuito? R: O Cursor tem um tier gratuito com requisições IA limitadas. Assinatura Pro disponível para acesso ilimitado.

P: Posso usar minhas próprias chaves de API? R: Sim, você pode configurar chaves de API OpenAI ou Anthropic nas configurações do Cursor.

P: O Cursor funciona offline? R: Edição básica funciona offline, mas recursos de IA requerem internet.

Perguntas Específicas do AIOX

P: Como mudo entre agentes? R: Use @mentions no chat: @dev, @qa, @architect, etc.

P: Posso usar múltiplos agentes em um prompt? R: Sim, mas é recomendado usar um agente por tarefa para clareza.

P: Onde as definições de agentes são armazenadas? R: Em .cursor/rules/ após a sincronização.

P: Como atualizo os agentes? R: Execute npm run sync:ide após atualizações do AIOX.

Migração

Do VS Code para Cursor

O Cursor importa configurações do VS Code automaticamente
Instale o AIOX:
```
npx @anthropic/aiox init --ide cursor
```
Suas extensões VS Code devem funcionar no Cursor

Do Cursor para Claude Code

Exporte regras personalizadas:

cp -r .cursor/rules/ cursor-rules-backup/

Inicialize AIOX para Claude Code:

npx @anthropic/aiox init --ide claude-code

Agentes sincronizam automaticamente para o novo formato

Exporte configuração:

cp .cursor/rules.md cursor-rules-backup.md

FilesExpand file tree

cursor.md

Latest commit

History

cursor.md

File metadata and controls

Guia AIOX para Cursor

Visão Geral

O que é o Cursor?

Por que usar AIOX com Cursor?

Comparação com Outras Plataformas

Requisitos

Requisitos de Sistema

Requisitos de Conta

Configuração Recomendada

Instalação

Passo 1: Instalar o Cursor

Passo 2: Configurar as Configurações do Cursor

Passo 3: Instalar o AIOX

Passo 4: Verificar a Instalação

Configuração

Arquivo de Regras Principal

Pasta de Regras de Agentes

Configurações do Cursor

Configuração MCP

Uso Básico

Iniciando o Cursor com AIOX

Ativando Agentes AIOX

Exemplos de Ativação de Agentes

Usando o Composer

Usando @codebase

Uso Avançado

Fluxos de Trabalho do Composer

Refatoração Multi-Arquivo

Implementação de Feature

Modos de Chat

Edição Inline

Organização de Regras

Recursos Específicos do Cursor

Superpoderes

Atalhos de Teclado

Referências de Contexto

Seleção de Modelo

Sincronização de Agentes

Como Funciona

Comandos de Sincronização

Formato de Arquivo de Agente

Resolução de Conflitos

Limitações Conhecidas

Limitações Atuais

Cursor vs Claude Code

Problemas Conhecidos

Troubleshooting

Problemas Comuns

Regras Não Carregando

MCP Não Funcionando

Performance Lenta

Agente Não Reconhecido

Logs e Diagnósticos

Resetar Configuração

FAQ

Perguntas Gerais

Perguntas Específicas do AIOX

Migração

Do VS Code para Cursor

Do Cursor para Claude Code

Recursos Adicionais

Documentação Oficial

Comunidade

Tutoriais