Indexa tu código una vez y deja que el Agent de Cursor lo resuelva

La indexación de código de Cursor dota a su modo Agent de comprensión semántica de toda la estructura de tu proyecto, sin cambiar de contexto manualmente. Indexa una vez y luego describe tareas de alto nivel en lenguaje natural: el Agent explorará archivos de forma autónoma, hará ediciones en varios archivos, ejecutará pruebas e iterará hasta terminar, recortando entre un 50 y un 70 % el tiempo de desarrollo de funcionalidades complejas.

La característica distintiva de Cursor no es el autocompletado, sino la indexación del código. A diferencia de los plugins de IDE que solo ven tu archivo actual, Cursor construye un índice semántico de todo tu repositorio, lo que da a la IA un contexto profundo sobre la estructura, los patrones y las dependencias de tu proyecto. Esto transforma el modo Agent: pasa de adivinar a razonar.

Configura la indexación inmediatamente después de clonar un repositorio: abre Cursor, pulsa Cmd+Shift+P, busca «Cursor: Index Codebase» y espera a que se construya el índice. Esto ocurre una sola vez y persiste. Ahora, cuando describas una tarea al modo Agent (Cmd+L y luego cambia a Agent), la IA leerá el índice antes de hacer cambios y entenderá cómo se propagan por el código las ediciones realizadas en un archivo.

Un flujo de trabajo profesional concreto: en lugar de explorar archivos manualmente para refactorizar un módulo heredado, escribe un prompt acotado como «Añade un middleware de límite de peticiones a POST /api/users, actualiza las definiciones de tipos en la carpeta types y escribe pruebas de Vitest». El modo Agent con contexto del código explorará los archivos relevantes, hará cambios en varios archivos, ejecutará las pruebas, detectará errores e iterará, terminando en 15-30 minutos lo que normalmente llevaría 2-3 horas. Usa las menciones @codebase y @folder para orientar el contexto hacia áreas específicas cuando la tarea sea compleja. Los equipos informan de una velocidad de desarrollo 2-3 veces mayor cuando indexan desde el principio y usan el modo Agent para tareas de varios archivos en lugar de ediciones de un solo archivo.