zvec-ai/zvec-grep

무엇을 해결하는가

zvec-grep (zg)는 인간과 AI 에이전트 모두가 소스 코드, 문서 및 구조화된 데이터 전반에서 정보를 찾을 수 있도록 하는 통합된 로컬 우선(local-first) 검색 레이어를 제공합니다. 이는 키워드 검색(grep과 같은)이 너무 경직되어 있고 순수 의미론적 검색은 부정확할 수 있는 대규모 워크스페이스에서의 비효율적인 검색 문제를 해결하여, 에이전트가 적절한 증거를 찾는 데 필요한 도구 호출 및 토큰 수를 줄여줍니다.

작동 방식

다음 세 가지 서로 다른 검색 방법론을 하나의 인터페이스로 통합합니다:

1. Ripgrep: 정확한 텍스트 및 정규식 매칭을 위해.
2. BM25: 전통적인 어휘 순위 지정(lexical ranking)을 위해.
3. Vector Search: 의미에 기반한 의미론적 발견을 위해.

사용자는 워크스페이스를 로컬에 인덱싱할 수 있으며, 이 도구는 CLI를 통해 사용하거나 Model Context Protocol (MCP)를 통해 AI 에이전트(Claude Code 또는 OpenCode와 같은)에 통합하여 사용할 수 있습니다. 데이터와 인덱스는 기본적으로 로컬 머신에 유지됩니다.

대상 사용자

• 개발자: 로컬 파일에 대한 강력하고 다중 모드(multi-modal) 검색 도구를 원하는 사용자.
• AI 에이전트 제작자: 복잡한 코드베이스나 문서 세트를 탐색하기 위해 에이전트에게 고정밀 검색 도구를 제공하고자 하는 사용자.
• 사용자: 로컬 우선 인덱싱 및 임베딩 모델이 필요한 데이터 프라이버시를 우선시하는 사용자.

주요 특징

• Hybrid Search: 발견과 정밀도의 균형을 맞추기 위해 의미론적, 어휘적, 정규식 검색을 결합합니다.
• Agent-Ready: 에이전트가 언제 어떻게 검색할지를 자율적으로 결정할 수 있도록 내장된 통합 기능을 제공합니다.
• Local-First: 파일, 인덱스 및 모델을 사용자의 머신에 유지합니다.
• Multi-Format Support: 구조와 소스 위치를 유지하면서 소스 코드와 산문을 처리합니다.
• Performance Optimized: 에이전트를 위한 모델 컨텍스트 노이즈와 도구 호출 빈도를 줄여줍니다.