zvec-grep CLI
Локальный поиск zg по рабочему пространству: ripgrep, BM25 и векторный поиск в одном инструменте для человека и агента
- 4 308 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Запускает локальный CLI и MCP-сервер, который индексирует файлы проекта в папку .zvec-grep
- С удаленной моделью эмбеддингов отправляет фрагменты файлов ее провайдеру
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/zvec-grepОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запускает локальный CLI и MCP-сервер, который индексирует файлы проекта в папку .zvec-grep
- С удаленной моделью эмбеддингов отправляет фрагменты файлов ее провайдеру
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
zvec-grep, командой zg, объединяет точный поиск по regex как в ripgrep, полнотекстовый поиск BM25 и семантический векторный поиск в одном локальном индексе. Индекс строится один раз над папкой проекта и хранится в скрытой директории .zvec-grep. Инструмент ищет по исходному коду, документам и структурированным данным, сохраняя привязку к исходному месту в файле. Работает как обычная команда в терминале или как сервер, к которому подключается агент через MCP, отдавая результаты с указанием источника, чтобы агенту требовалось меньше повторных вызовов и меньше токенов на объяснение контекста.
Для кого. Для разработчиков и кодинг-агентов, которым нужен единый поиск по смыслу и по точному тексту в большом рабочем пространстве.
Подходит, если
- Агенту нужно найти релевантный код или документ по смыслу, а не только по ключевому слову
- Нужен единый индекс, который можно использовать и из терминала, и из агента
- Важно сократить число вызовов инструмента поиска и объем возвращаемого контекста
Не подходит, если
- Достаточно обычного grep или ripgrep без семантического поиска
- Не хочется держать локальный индекс и модель эмбеддингов
Пример запроса к агенту
Найди в проекте место, где обрабатывается ошибка авторизации, по смыслу, а не по точному текстуОграничения
Нужен Node.js версии 22 и выше. Перед поиском требуется построить индекс командой zg index, а для семантического поиска выбрать модель эмбеддингов, локальную или удаленную. При использовании удаленных эмбеддингов данные уходят к их провайдеру только с явного разрешения.
Как отключить. Удалите пакет командой npm uninstall -g @zvec/zvec-grep и сотрите папку .zvec-grep с индексом в каждом проекте, где он строился.
Частые вопросы
Нужен ли облачный ключ для эмбеддингов?
Нет, можно выбрать локальную модель эмбеддингов, такую как potion-retrieval-32m, тогда все остается на машине.
Чем zg отличается от обычного ripgrep?
zg добавляет полнотекстовый поиск BM25 и векторный поиск по смыслу поверх привычного точного поиска, объединяя их в одном локальном индексе.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыJevGrep ищет код по описанию задачи: выдает строки с путями и номерами, работает из терминала и как MCP-сервер агента.
codesearch ищет по коду сразу в нескольких репозиториях гибридным поиском и работает офлайн, без GPU и Docker.
Поиск по исходникам ранжирует совпадения с учетом структуры кода и дает агенту нужные фрагменты без отдельного индекса.
Jevgrep
jevgrep
CLI для кодовых агентов: ищет код по описанию задачи, а не по строке. Нужен ключ одного из провайдеров моделей
Локальный поиск по коду для агентов на Rust: BM25, векторы и реранкинг, 65 языков, без сети, со скиллом и MCP-сервером.
Локальный поиск и MCP-сервер для агентов: один бинарник на Rust индексирует код, документы и логи
Коротко о README
README описывает zvec-grep как локальный слой поиска для людей и агентов на базе движка zvec: ripgrep, BM25 и векторный поиск объединены в одном интерфейсе командной строки и MCP-сервере. Есть отдельная документация по интеграции с Codex, Claude Code, Qwen Code, Qoder, Cursor, GitHub Copilot, VS Code и OpenCode. TypeScript-реализация описана в основном README, отдельная Rust-реализация развивается в папке rust. Лицензия Apache 2.0.