СтатьяГайдCursor AI не видит файлы проекта: как заставить агента сканировать репу
Cursor AI не видит файлы проекта: в чём главная боль
У меня в репе вчера приключилась классическая засада: открываю проект, запускаю композит из агентов, а эта зараза в упор не видит новые компоненты, которые я только что набросал. Пишу в чат: «Посмотри логику в соседнем файле», а в ответ получаю классическое «я не могу найти этот файл в рабочей директории».
Бесит невероятно, особенно когда дедлайн горит, а ИИ начинает галлюцинировать вместо анализа кодовой базы. Пришлось лезть под капот редактора и разбираться, почему индексатор теряет контекст. Спойлер: дело чаще всего не в самом Cursor, а в том, как открыта папка или что записано в служебных файлах.
Как добавить папку в Cursor AI и проверить корень проекта
Первая и самая тупая ошибка, на которую я сам регулярно напарываюсь — открывать не корень репозитория, а случайную вложенную папку. Если запустить редактор через терминал не из той директории, индексатор просто не цепляет соседей.
Проверьте, что в левой панели у вас открыт именно workspace, а не отдельный подкаталог. Если папка добавлена криво, агент будет видеть только её маленький мир.
Кликните в верхнем меню на File -> Open Folder и выберите корень с вашим package.json или go.mod.
Убедитесь, что в рабочей области нет дублирующих вложенных воркспейсов, которые путают поисковый движок.
IDE sidebar file tree open project
Cursor AI игнорирует gitignore: где искать подвох
Вторая частая причина — ваш файл .gitignore. Агенты в Cursor по умолчанию уважают правила Git, чтобы не тащить в контекст тонны мусора, папки node_modules, сборки или секретные env-файлы.
Но иногда под раздачу попадают конфиги, папки с бэкапами или сгенерированные схемы, которые нужны ИИ для работы. Если файл подсвечен серым или исключен из поиска, агент его просто не считает.
Гляньте в настройки редактора по запросу Use Ignore Files и проверьте, не включено ли там лишнее.
Создайте локальный файл .cursorignore, если хотите явно указать агенту, что именно игнорировать, не ломая при этом основной гитигнор.
Слетел индекс: как принудительно перезапустить сканирование
Иногда база данных индексов внутри Cursor просто ломается после обновления или резкого закрытия IDE. В таком случае файлы физически на диске есть, в дереве они отображаются, но поиск и чат их игнорируют.
Лечится это принудительным пересчётом эмбеддингов. Пришлось поискать в панели команд нужный пункт, потому что интуитивно он не бросается в глаза.
Откройте палитру команд через Ctrl+Shift+P или Cmd+Shift+P.
Найдите пункт Reindex Workspace или аналогичную команду сброса локального индекса кодовой базы.
Что ещё проверить в настройках, если файлы всё равно пропали
Если ничего из вышеперечисленного не помогло, проблема может крыться в глобальных исключениях самого движка VS Code, на базе которого собран Cursor.
Иногда туда попадают полезные расширения или специфические директории сгенерированного кода.
Загляните в Settings -> Search: Exclude и проверьте, нет ли там масок, блокирующих ваши рабочие папки.
Перезапустите IDE после любых правок в конфигурации, чтобы демон индексации подхватил изменения с чистого листа.
settings menu IDE configuration screen
Итог: краткий чек-лист для спасения агента
В общем, если боитесь снова потерять контекст в процессе работы с кодом, держите мой личный мини-алгоритм действий:
Я не врач и не техподдержка разработчиков редактора, но этот набор шагов у меня в команде решает 99% подобных косяков с индексацией за пару минут.
Открыт ли именно корень репозитория?
Не прячется ли нужный файл за правилами gitignore?