프로젝트 소개

zvec-grep(zg)은 사람 사용자와 AI 에이전트 모두를 위해 설계된 워크스페이스용 로컬 우선 검색 계층이다. ripgrep, BM25, 벡터 검색을 단일 인터페이스 뒤에 결합하여 사용자가 의미로 검색하고, 관련성에 따라 결과를 정렬하며, 정확한 텍스트나 정규식으로 발견 사항을 검증할 수 있게 한다. 이 도구는 소스 코드, 문서, 구조화된 데이터를 지원하면서 구조와 소스 위치를 보존한다. 주요 기능으로는 CLI 및 에이전트 통합, 다중 형식 검색, 소스 연결 순위 결과, 그리고 파일·인덱스·로컬 모델이 사용자 기기에 유지되는 로컬 기본 작동이 포함된다. 원격 임베딩은 허가가 있을 때만 사용된다. 이 프로젝트는 TypeScript/Node.js 구현을 제공하며, 별도의 Rust 구현이 개발 중이다. 설치에는 Node.js 22 이상이 필요하다. 사용자는 npm을 통해 전역 설치하고, `zg index`로 워크스페이스를 인덱싱하고, `zg query`로 쿼리할 수 있다. 에이전트 통합은 OpenCode, Codex, Claude Code, Qwen Code, Qoder, Cursor, GitHub Copilot, VS Code, Grok Build 등에서 사용할 수 있다. 이 도구는 안전한 에이전트 접근을 위해 MCP도 지원한다. 문서에는 에이전트 통합, CLI 사용법, MCP, 검색 파이프라인, 아키텍처, 서버 및 실행 모드, 임베딩 모델, 로드맵이 포함된다. 벤치마크에는 SWE-QA-Bench와 BrowseComp-Plus에 대한 교차 도메인 에이전트 평가와 Pylint, Matplotlib, Django 저장소를 사용한 실제 사례 연구가 포함된다.