zvec-grep
Локальный поиск zg по рабочему пространству: ripgrep, BM25 и векторный поиск в одном инструменте для человека и агента
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Инструмент индексирует и читает файлы проекта локально, запись в проект не производится
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/zvec-grepОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Установите утилиту
npm install -g @zvec/zvec-grepУстановите инструмент командой npm install -g @zvec/zvec-grep, затем в папке проекта постройте индекс: zg index --embedding local/potion-retrieval-32m. Подключите zg к агенту по инструкции docs/01-agents.md для нужного клиента, Claude Code, Cursor или другого.
Другие способы из описания автора
npm install -g @zvec/zvec-grepТребуется Node.js 22 или новее.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
zvec-grep, командой zg, объединяет точный поиск по regex как в ripgrep, полнотекстовый поиск BM25 и семантический векторный поиск в одном локальном индексе. Индекс строится один раз над папкой проекта и хранится в скрытой директории .zvec-grep. Инструмент ищет по исходному коду, документам и структурированным данным, сохраняя привязку к исходному месту в файле. Работает как обычная команда в терминале или как сервер, к которому подключается агент через MCP, отдавая результаты с указанием источника, чтобы агенту требовалось меньше повторных вызовов и меньше токенов на объяснение контекста.
Для кого. Для разработчиков и кодинг-агентов, которым нужен единый поиск по смыслу и по точному тексту в большом рабочем пространстве.
Подходит, если
- Агенту нужно найти релевантный код или документ по смыслу, а не только по ключевому слову
- Нужен единый индекс, который можно использовать и из терминала, и из агента
- Важно сократить число вызовов инструмента поиска и объем возвращаемого контекста
Не подходит, если
- Достаточно обычного grep или ripgrep без семантического поиска
- Не хочется держать локальный индекс и модель эмбеддингов
Пример запроса к агенту
Найди в проекте место, где обрабатывается ошибка авторизации, по смыслу, а не по точному текстуОграничения
Нужен Node.js версии 22 и выше. Перед поиском требуется построить индекс командой zg index, а для семантического поиска выбрать модель эмбеддингов, локальную или удаленную. При использовании удаленных эмбеддингов данные уходят к их провайдеру только с явного разрешения.
Как отключить. Удалите пакет командой npm uninstall -g @zvec/zvec-grep и сотрите папку .zvec-grep с индексом в каждом проекте, где он строился.
Проверка безопасности
- Инструмент индексирует и читает файлы проекта локально, запись в проект не производится
Коротко о 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.
Частые вопросы
Нужен ли облачный ключ для эмбеддингов?
Нет, можно выбрать локальную модель эмбеддингов, такую как potion-retrieval-32m, тогда все остается на машине.
Чем zg отличается от обычного ripgrep?
zg добавляет полнотекстовый поиск BM25 и векторный поиск по смыслу поверх привычного точного поиска, объединяя их в одном локальном индексе.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything