Indexação da codebase

Como o Cursor aprende tua codebase para entender melhor

O Cursor indexa tua codebase calculando embeddings para cada arquivo. Isso melhora as respostas geradas por IA sobre teu código. Quando tu abres um projeto, o Cursor começa a indexar automaticamente. Novos arquivos são indexados incrementalmente. Confere o status da indexação em: Cursor Settings > Indexing & Docs

Configuração

O Cursor indexa todos os arquivos, exceto os listados nos arquivos de ignore (por exemplo, .gitignore, .cursorignore).

Clica em Show Settings para:

• Ativar a indexação automática para novos repositórios
• Configurar quais arquivos devem ser ignorados

Ignorar arquivos grandes de conteúdo melhora a precisão das respostas.

Ver arquivos indexados

Pra ver os caminhos dos arquivos indexados: Cursor Settings > Indexing & Docs > View included files

Isso abre um arquivo .txt com a lista de todos os arquivos indexados.

Espaços de trabalho multiraiz

Cursor oferece suporte a espaços de trabalho multiraiz, permitindo que tu trabalhes com múltiplas bases de código:

• Todas as bases de código são indexadas automaticamente
• O contexto de cada base de código fica disponível para a IA
• .cursor/rules funciona em todas as pastas

Busca por PR

A busca por PR ajuda você a entender a evolução da sua base de código, tornando mudanças históricas pesquisáveis e acessíveis via IA.

Como funciona

O Cursor indexa automaticamente todos os PRs mesclados do histórico do seu repositório. Resumos aparecem nos resultados de busca semântica, com filtros inteligentes que priorizam mudanças recentes.

O Agent pode trazer PRs, commits, issues ou branches para o contexto usando @[PR number], @[commit hash] ou @[branch name]. Inclui comentários do GitHub e revisões do Bugbot quando conectado.

Plataformas compatíveis: GitHub, GitHub Enterprise e Bitbucket. GitLab não é compatível no momento.

Usuários do GitHub Enterprise: a ferramenta de fetch recorre a comandos git devido a limitações de autenticação do VSCode.

Usando a busca por PR

Faz perguntas como “Como os serviços são implementados em outros PRs?” e o Agent vai buscar automaticamente PRs relevantes para o contexto e fornecer respostas abrangentes com base no histórico do seu repositório.

FAQ

Where can I see all indexed codebases?

Ainda não existe uma lista global. Confere cada projeto individualmente abrindo-o no Cursor e checando as configurações de Codebase Indexing.

How do I delete all indexed codebases?

Exclui tua conta do Cursor em Settings para remover todas as codebases indexadas. Caso contrário, exclui as codebases individualmente nas configurações de Codebase Indexing de cada projeto.

How long are indexed codebases retained?

As codebases indexadas são excluídas após 6 semanas de inatividade. Reabrir o projeto dispara uma nova indexação.

Is my source code stored on Cursor servers?

Não. O Cursor cria embeddings sem armazenar nomes de arquivo ou código-fonte. Os nomes de arquivo são ofuscados e os trechos de código são criptografados.

Quando o Agent pesquisa a codebase, o Cursor recupera os embeddings do servidor e descriptografa os trechos.