codespelunker CLI
Поиск по исходникам ранжирует совпадения с учетом структуры кода и дает агенту нужные фрагменты без отдельного индекса.
- 1 080 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Агент читает доступные пользователю исходники; включенная синхронизация Git обновляет рабочие копии.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/codespelunkerОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент читает доступные пользователю исходники; включенная синхронизация Git обновляет рабочие копии.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
codespelunker ищет по файлам проекта и поднимает выше совпадения, которые считает более подходящими к запросу. Агент может отделить код от комментариев, найти объявления или места использования и получить фрагмент с именем файла и строками. Поиск выполняется по текущим файлам без предварительного построения индекса. Кроме обычного вывода в терминал есть интерактивный просмотр, HTTP-интерфейс и MCP-сервер. Через MCP агент ищет и читает выбранные строки файла. Профили ранжирования помогают сузить выдачу до основного кода или расширить ее, включая тесты.
Для кого. Разработчикам, изучающим незнакомый проект и подбирающим для агента реализацию функции с соседними строками кода.
Подходит, если
- Имя функции встречается и в коде, и в документации, а агенту нужна реализация.
- При разборе ошибки полезно найти строки с конкретным сообщением.
- Новый проект нужно исследовать без обслуживания поискового индекса.
- Для чтения исходников через MCP требуется ограничить агента одной папкой.
Не подходит, если
- Вы хотите автоматически переписать найденные синтаксические конструкции.
- Результат должен включать полный межпроектный граф зависимостей и вызовов.
- Порядок выдачи обязан доказывать корректность найденной реализации.
Пример запроса к агенту
Найди реализацию авторизации, исключи комментарии и покажи наиболее подходящие файлы со строками кода.Ограничения
Установка через Go требует версии 1.25.2 или новее; готовые бинарники доступны отдельно. Определение объявлений работает для перечисленных языков, а для остальных совпадения ранжируются как обычные использования. В MCP параметр `--dir` задает только исходную папку: ограничение чтения включают отдельно через `--mcp-lock-dir`. Необязательная синхронизация Git выполняет `pull` и меняет локальные копии, поэтому включайте ее только для разрешенных рабочих каталогов.
Как отключить. Завершите процесс cs или удалите его запись из настроек MCP-клиента. Если включали синхронизацию Git, проверьте полученные изменения отдельно.
Частые вопросы
Нужно ли сначала строить индекс?
Нет. codespelunker читает текущие файлы при каждом запросе; можно сразу искать по каталогу проекта.
Как искать только комментарии?
Укажите `--only-comments`; для кода и строк есть отдельные фильтры.
Как видеть больше тестов?
Выберите профиль `broad`, который включает тестовые файлы с полным весом.
Что агент получит от поиска?
Имена файлов, положение совпадений, фрагменты текста и оценки релевантности.
Почему поиск вышел за папку проекта?
В MCP значение `--dir` само по себе не запрещает другие пути. Включите `--mcp-lock-dir`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыMCP сервер структурного поиска по коду для агентов: находит нужный файл по смыслу запроса и работает локально
Быстрый семантический поиск по коду для агентов: возвращает нужные фрагменты вместо чтения файлов и тратит намного меньше токенов
MCP-сервер ищет определения и смысловые фрагменты кода по локальному индексу, объединяя векторы и полнотекстовый поиск.
MCP-сервер индексирует локальный репозиторий через tree-sitter и дает агенту поиск по коду, список файлов и сводку по структуре файла
MCP-сервер, который индексирует код через tree-sitter и отдает агенту отдельные функции и классы вместо целых файлов
Локальный индекс кодовой базы для агентов: гибридный поиск, графы зависимостей и анализ последствий изменений
Коротко о README
Поддерживаются логические выражения, регулярные выражения и нечеткий поиск. Параметры MCP вне документированного набора вызывают ошибку.