Vera CLI
Локальный поиск по коду для агентов на Rust: BM25, векторы и реранкинг, 65 языков, без сети, со скиллом и MCP-сервером.
- 147 ★ репозитория
- Последний коммит
- MIT
Минимальный доступ
Почему такой уровень
- Установщик скачивает бинарник и модель и записывает скилл в каталоги агентов.
Установка
- Работает в
Ручная установка
bunx @vera-ai/cli installПервый вариант быстрого старта в README, затем `vera setup --potion-code --index .`. Вместо `bunx` подойдут `npx -y @vera-ai/cli install` и `uvx vera-ai install`.
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Установщик скачивает бинарник и модель и записывает скилл в каталоги агентов.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Vera ищет код по смыслу и по имени. Запрос «где чистятся просроченные сессии» возвращает функции и классы с путями и диапазонами строк, а `parse_config` находит ту же функцию по точному названию. Каждый запрос сочетает BM25 и поиск по эмбеддингам, затем применяет ранжирование, которое ставит определения выше упоминаний, а исходники выше тестов и документации. Программа работает одним нативным бинарником. Индекс лежит в проекте, поиск идет на вашем компьютере, модель по умолчанию запускается на обычном процессоре. Команда `vera agent install` ставит скилл более чем в 30 клиентов агентов, а `vera mcp` запускает MCP-сервер с семью инструментами, среди них `search_code`, `find_references` и `structural_search`.
Для кого. Разработчикам, чьи агенты тратят токены на чтение лишних файлов в больших репозиториях и не должны отправлять код во внешний индекс.
Подходит, если
- Агент не находит нужную функцию в монорепозитории по описанию поведения.
- Перед рефакторингом надо увидеть, кто вызывает символ и какие функции остались без вызовов.
- Код нельзя отправлять во внешние сервисы, а поиск нужен на своей машине.
- Одним запросом ищут и по проекту, и по исходникам зависимостей из `~/.cargo/registry`.
Не подходит, если
- Репозиторий крошечный: обычного `grep` достаточно.
- Нужен поиск по документам, переписке или базе знаний, а не по коду.
- Среда закрыта от скачивания бинарника и модели: понадобится ручная установка по инструкции.
Пример запроса к агенту
Найди через Vera, где в проекте обрабатывается истечение сессий, и покажи функции с путями и вызывающим кодом.Ограничения
Первый запуск скачивает нативный бинарник, модель эмбеддингов и ONNX Runtime, поэтому нужен доступ в сеть либо ручная установка. Символьные куски дают 54 из 65 языков, остальные файлы режутся по разделам или окнам строк. Для индекса в большом дереве нужен отдельный проход, а режим `--full-text-only` не использует модель и ищет только по BM25. Linux на aarch64 требует glibc, сборки musl для него нет. Показатели скорости и качества в README измерены самим автором на его машине.
Как отключить. Удалите скилл командами установщика или вручную из каталогов агентов, уберите запись `vera` из конфигурации MCP и удалите бинарник. Индекс лежит в проекте, его удаляют вместе с папкой индекса.
Частые вопросы
Что лучше подключать: скилл или MCP?
Лучше CLI со скиллом, так советует README. Скилл объясняет агенту, когда брать `vera search`, `vera references` или обычный `grep`. MCP-сервер `vera mcp` нужен клиентам, которые предпочитают его.
Уходит ли код во внешний сервис?
По умолчанию нет: индекс, хранилище и поиск работают на вашем компьютере, модель запускается на процессоре без ключа API. Внешний бэкенд эмбеддингов включают отдельно.
Как обновлять индекс?
Команда `vera update .` пересчитывает только измененные файлы, а `vera watch .` делает это постоянно.
Как искать по зависимостям?
Один раз выполните `vera index ~/.cargo/registry/src --full-text-only`, затем запрос с `--also ~/.cargo/registry/src` объединит списки.
В какие агенты ставится скилл?
Установщик поддерживает более 30 клиентов, среди них Claude Code, Codex, Cursor, OpenCode, Gemini CLI и Copilot. Для остальных подходит `npx skills add VeraTools/Vera`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыЛокальный поиск и MCP-сервер для агентов: один бинарник на Rust индексирует код, документы и логи
codesearch ищет по коду сразу в нескольких репозиториях гибридным поиском и работает офлайн, без GPU и Docker.
Поиск по исходникам ранжирует совпадения с учетом структуры кода и дает агенту нужные фрагменты без отдельного индекса.
MCP-сервер индексирует локальный репозиторий через tree-sitter и дает агенту поиск по коду, список файлов и сводку по структуре файла
MCP сервер структурного поиска по коду для агентов: находит нужный файл по смыслу запроса и работает локально
Vexor: смысловой поиск по файлам и коду с MCP-сервером, где агент находит нужный файл по описанию его содержимого.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Vera (эта карточка) | нет | 147 | ||
| semble | да | не нужна | 6 404 | тоже ищет по коду локально без ключей; Vera сочетает BM25 с эмбеддингами и дополнительно отвечает на структурные вопросы: определения, вызовы, функции без вызовов |
| Serena | нет | не нужна | 31 301 | работает через языковые серверы и правит код символами; Vera только ищет по индексу и не меняет файлы |
Коротко о README
README объясняет быстрый старт, принцип поиска, настройку скилла и MCP-сервера, сравнение с другими локальными инструментами и ссылки на подробные страницы документации.