СтатьяГайд

Cursor AI не видит файлы проекта: как заставить агента сканировать репу

Автор отметил, что материал написан или существенно правлен с помощью ИИ (Редакционный ИИ-агент).

Cursor AI не видит файлы проекта: как заставить агента сканировать репу

Cursor AI не видит файлы проекта: в чём главная боль

У меня в репе вчера приключилась классическая засада: открываю проект, запускаю композит из агентов, а эта зараза в упор не видит новые компоненты, которые я только что набросал. Пишу в чат: «Посмотри логику в соседнем файле», а в ответ получаю классическое «я не могу найти этот файл в рабочей директории».

Бесит невероятно, особенно когда дедлайн горит, а ИИ начинает галлюцинировать вместо анализа кодовой базы. Пришлось лезть под капот редактора и разбираться, почему индексатор теряет контекст. Спойлер: дело чаще всего не в самом Cursor, а в том, как открыта папка или что записано в служебных файлах.

Как добавить папку в Cursor AI и проверить корень проекта

Первая и самая тупая ошибка, на которую я сам регулярно напарываюсь — открывать не корень репозитория, а случайную вложенную папку. Если запустить редактор через терминал не из той директории, индексатор просто не цепляет соседей.

Проверьте, что в левой панели у вас открыт именно workspace, а не отдельный подкаталог. Если папка добавлена криво, агент будет видеть только её маленький мир.

  • Кликните в верхнем меню на File -> Open Folder и выберите корень с вашим package.json или go.mod.
  • Убедитесь, что в рабочей области нет дублирующих вложенных воркспейсов, которые путают поисковый движок.
Как добавить папку в Cursor AI и проверить корень проекта
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?
  • Жив ли локальный индекс проекта?
  • Не заблокирован ли поиск в настройках exclude?
  • Помог ли банальный перезапуск воркспейса?
0
18

Комментарии (0)

Войдите, чтобы комментировать.

Без Plus — 5 комментариев в месяц. Мало слов — чистый воздух. Войти

Комментариев пока нет — будьте первым.

Ещё в теме «Код и разработка»

Похожие материалы и соседние разборы

Никита Орлов

Симптом: Cursor IDE не видит локальный интерпретатор Python Симптом: при открытии проекта в Cursor IDE линтер ругается на отсутствие модулей, а в правом нижнем углу или через палитру команд не удается выбрать локальный интерпретатор из папки .venv. Поведение воспроизводится при открытии нового воркспейса на базе стандартного модуля venv или Poetry без явно прописанных путей в конфигурации рабочей зоны. Причина сбоя: расхождение путей в settings.json и workspace Поскольку Cursor построен на базе VS Code, он использует те же механизмы поиска интерпретаторов, но часто теряет контекст проекта из-за структуры вложенных папок или монорепозиториев. Если в настройках воркспейса жестко не зафиксирован путь к исполняемому файлу python, сканер окружения падает по таймауту или берет дефолтную системную версию. Фиксим через ручную правку settings.json

Показать полностью
0
24
Никита Орлов

Как не упереться в лимит запросов в Claude Code и что делать Короче, если вы уже крутите Claude Code в терминале, то наверняка видели эту злую ошибку про rate limit. Сидишь такой, дебажишь сложный баг, агент бодро пишет код, рефакторит тесты — и тут бац: «Rate limit reached». Всё, приплыли, кукушка говорит «ждите час» или сколько там до сброса. У меня такое происходит регулярно, если дать агенту волю. Раньше я просто пускал его в проект и говорил: «Почини всё». Это главная ошибка. Claude начинает читать вообще всю репу, тащит в контекст гигабайты логов и node_modules, если они не заигнорены, и сжирает месячный лимит токенов за полчаса активной работы. Давайте разберем, как я теперь экономлю запросы и выживаю без нервных срывов. Почему улетает claude code rate limit и как с этим жить Основная проблема — контекст. Агенты устроены так, что с

Как не упереться в лимит запросов в Claude Code и что делатьПоказать полностью
0
17
Никита Орлов

Зачем вообще запускать локальные модели для кода У меня в репе лежат приватные ключи, проприетарные алгоритмы и куча legacy, которую стыдно показывать даже коллегам, не то что облачным провайдерам. Вчера очередной агент попытался слить кусок контекста наружу, и я психанул. Решил, что хватит кормить чужие датасеты своими энтерпрайз-костылями. Поставил Ollama, выделил под это дело локальную тачку с нормальной видюхой и начал тестировать лучшие модели для кода локально. Главный критерий простой: чтобы она не тупила на автодополнении в Cursor или VS Code и выдавала рабочий синтаксис с первой попытки, а не генерировала синтаксический мусор. Ниже — мой личный топ-5 локальных нейросетей для программирования, которые я потрогал руками, покрутил в разных сценариях и отобрал для повседневной разработки. 1. DeepSeek-Coder-V2: тяжёлая артиллерия для

Какие локальные LLM для написания кода запустить: топ-5 моделейПоказать полностью
0
19
Никита Орлов

Какие фреймворки для разработки AI-агентов использовать в 2024 году Привет! У меня тут на днях агент в очередной раз улетел в бесконечный цикл, сжег кучу токенов на OpenAI и затер локальную базу тестов. Классика для ночной смены. Если вы тоже устали от красивых демок на Streamlit, которые сыпятся на первом же нестандартном ответе модели, давайте смотреть на фреймворки для AI агентов с точки зрения инженера. Мне важен не столько красивый синтаксис графов, сколько стабильность под нагрузкой, нормальный async, человеческий логгинг и понимание, куда делся стейт, когда упал воркер. Короче, собрал пятерку инструментов, которые я сам крутил в продакшене, и готов выдать честное сравнение. LangGraph: когда нужен жесткий контроль стейта LangGraph от создателей LangChain — это первое, куда я смотрю, когда логика агента перестает помещаться в один

Фреймворки для AI агентов в продакшене: топ 5 инструментовПоказать полностью
0
27
Павел Дронов

Зачем мы вообще стали искать дешевую CRM для малого бизнеса Привет! На связи Павел Дронов. У нас тут небольшая точка, клиенты идут потоком, и в какой-то момент блокноты и таблички в Excel просто треснули по швам. Менеджер забыл перезвонить, кто-то потерял чек, клиент ушел к конкурентам. Знакомая картина, да? Я сел выбирать софт и схватился за голову. Цены на некоторые разрекламированные системы улетают в космос — смотришь на тариф, а там подписки на три-пять тысяч в месяц за каждого сотрудника. Для маленького бизнеса это разорительно. Мы не корпорация, нам не нужны космические отчеты по эффективности каждого отдела или интеграция с какими-то заморскими сервисами. Нам нужно, чтобы воронка продаж не забивалась, клиенты получали вовремя смски, а база не терялась. Поэтому я потратил пару недель, протестировал с десяток вариантов и собрал личный топ

Дешевые CRM для малого бизнеса: топ и реальный счет за софтПоказать полностью
0
12
Никита Орлов

Введение в мультиагентные системы: почему старые подходы больше не тащат Привет! У меня в репе за последние полгода скопилось столько экспериментов с AI-агентами, что пора бы разложить всё по полочкам. Если раньше мы просто кидали промпты в LLM через API и радовались, то теперь бизнес требует полноценных конвейеров. Один агент пишет код, второй ищет баги, третий ревьюит — и всё это должно крутиться без падений. Пытаться писать такую оркестрацию на голом Python и костылях из asyncio — верный способ поседеть к релизу. Нужны нормальные фреймворки для мультиагентных систем, топ которых я как раз и хочу разобрать. Ниже — пять инструментов, которые мы щупали руками, ловили на них баги и собирали работающие контуры. LangGraph: когда нужен полный контроль над состоянием графа Первый кандидат в нашем списке — LangGraph от команды LangChain. Я начинал с

Фреймворки для мультиагентных систем: топ-5 инструментов в 2025Показать полностью
0
27