Cursor Indexing — это слой, из-за которого Agent быстро находит нужный код в репозитории: состав кодовой базы для AI-контекста задают ignore-правила, а точечный поиск делает Instant Grep. Канон по поиску: docs Agent Search; по составу файлов: Ignore file (секция Indexing → Ignore Files с Cursor 3.11).
Исключения файлов — Ignore Files. Training/ZDR — Privacy Mode. Окно токенов — Context. Pillar: n8n для начинающих.
Для кого indexing
- Большой репозиторий: Agent должен находить символы без ручного @ на каждый файл.
- Нужно понять, что именно попадает в AI-контекст и поиск.
- Security: интересует шифрование путей и срок жизни индексов.
- Монорепа: режете шум через Ignore Files в секции Indexing.
Как пользоваться: маршрут на 10 минут
- Откройте проект в Cursor и дождитесь, пока среда подхватит workspace (индексация идёт в фоне под капотом).
- Закройте секреты и мусор:
.gitignore+.cursorignore. - При необходимости: Cursor Settings → Indexing → Ignore Files → Hierarchical Cursor Ignore.
- В Agent опирайтесь на точечные имена символов — сработает Instant Grep (regex/word-boundary).
- Для широкого обзора попросите Explore subagent: он ищет параллельно и возвращает сжатый отчёт.
| Механизм | Роль | Источник |
|---|---|---|
| Ignore Files / .cursorignore | Что Agent/Tab/@ не должны читать | docs/reference/ignore-file |
| .gitignore | Автоматически вне AI-контекста | help/ignore-files |
| Instant Grep | Exact/regex поиск быстрее ripgrep на больших репо | docs/agent/tools/search |
| Explore subagent | Параллельный обзор без раздувания основного чата | docs/agent/tools/search |
| Path encryption | Пути шифруются до серверов; код не в plaintext storage | docs/agent/tools/search |
| Index expiry | Indexed codebases: 6 weeks inactivity (enterprise hardening) | docs/enterprise/security-hardening |
Сверка: docs/agent/tools/search, docs/reference/ignore-file, docs/enterprise/security-hardening (проверка 2026-09-06). Отдельной публичной «force reindex» кнопки в актуальной Search-доке нет — не выдумываем UI.
Indexing vs ручной @ vs Max Mode
| Задача | Лучше indexing/search | Лучше другой рычаг |
|---|---|---|
| Найти все usages символа | Instant Grep / Agent search | — |
| Подложить 2-3 известных файла | Можно @ | @ mentions / Context |
| Убрать .env из контекста | Ignore Files | — |
| Не влезает окно на legacy | — | Max Mode (размер окна) |
| Запрет training | — | Privacy Mode |
Сильные стороны
- Agent сам ходит в поиск: не нужно вручную @ каждый файл.
- Instant Grep заточен под большие кодовые базы.
- Explore subagent бережёт context window основного чата.
- Состав индекса контролируется теми же ignore-правилами, что и контекст.
Типичные ошибки
- Ждать «магической семантики» от репо, где половина кода в ignored/generated деревьях.
- Путать indexing с Privacy Mode: индекс/поиск ≠ запрет training.
- Дублировать десятки @ поверх того, что Agent и так найдёт grep-ом.
- Считать path encryption заменой .cursorignore для секретов в промпте.
FAQ: Cursor Indexing
Что такое indexing в Cursor?
Indexing в Cursor — подготовка и сопровождение представления кодовой базы, чтобы Agent мог искать и подтягивать релевантный код. Управление составом индекса идёт через ignore-файлы и настройки Indexing. Поиск по символам/regex — Instant Grep в docs/agent/tools/search.
Как исключить файлы из индекса и контекста?
Используйте .gitignore и .cursorignore. Help прямо связывает ignore files с тем, что попадает в AI context. Настройки Hierarchical Ignore лежат в Cursor Settings → Indexing → Ignore Files (с версии 3.11).
Хранит ли Cursor код индекса в открытом виде?
Для search-пути дока Search пишет: пути файлов шифруются перед отправкой на серверы Cursor, code content не хранится в plaintext. Это не отменяет LLM-запросы с фрагментами кода при работе Agent.
Чем Instant Grep отличается от «семантики»?
Instant Grep — быстрый exact/regex поиск по кодовой базе (функция, строка ошибки, import.*Service). Он запускается автоматически, без отдельной настройки. Для широкого обзора Agent может поднять Explore subagent в отдельном окне контекста.
Сколько живёт проиндексированная кодовая база?
В enterprise security-hardening указано automatic expiry: indexed codebases удаляются после 6 weeks inactivity. При удалении аккаунта индексы пользователя тоже уходят в срок очистки аккаунта. Сверяйте актуальную формулировку в docs.
Вывод
Cursor Indexing — связка ignore-правил и поисковых инструментов Agent (Instant Grep, Explore). Настройте .cursorignore, проверьте Indexing → Ignore Files, не смешивайте с Privacy Mode. Дальше — Ignore Files и Context.
Хотите нейросети под свои задачи, а не «для всех»?
Когда базовых гайдов уже мало, помогает разбор под вашу работу. Наставничество, курсы и подписка Артёма Денисова — все форматы на странице обучения. Тех-pillar — n8n для начинающих.