Sobre el proyecto

zvec-grep (zg) es una capa de búsqueda local-first para espacios de trabajo, diseñada tanto para usuarios humanos como para agentes de IA. Combina ripgrep, BM25 y búsqueda vectorial tras una única interfaz, lo que permite a los usuarios buscar por significado, clasificar resultados por relevancia y verificar hallazgos con texto exacto o regex. La herramienta admite código fuente, documentos y datos estructurados, preservando la estructura y las ubicaciones de origen. Las características clave incluyen integraciones con CLI y agentes, búsqueda multiformato, resultados clasificados vinculados a la fuente y funcionamiento local por defecto, donde los archivos, índices y modelos locales permanecen en la máquina del usuario. Los embeddings remotos se utilizan solo con permiso. El proyecto proporciona una implementación en TypeScript/Node.js, con una implementación separada en Rust en desarrollo. La instalación requiere Node.js 22 o superior. Los usuarios pueden instalar globalmente mediante npm, indexar un espacio de trabajo con `zg index` y consultarlo con `zg query`. Hay integraciones de agentes disponibles para OpenCode, Codex, Claude Code, Qwen Code, Qoder, Cursor, GitHub Copilot, VS Code, Grok Build y otros. La herramienta también admite MCP para acceso seguro de agentes. La documentación cubre integraciones de agentes, uso de CLI, MCP, canalización de recuperación, arquitectura, modos de servidor y ejecución, modelos de embedding y hoja de ruta. Los benchmarks incluyen evaluaciones de agentes entre dominios en SWE-QA-Bench y BrowseComp-Plus, además de estudios de casos reales con repositorios de Pylint, Matplotlib y Django.