zvec-ai/zvec-grep

해결하는 문제

zvec-grep (일명 zg)은 인간과 AI 에이전트 모두가 작업 공간 내에서 정보를 효율적으로 찾을 수 있도록 설계된 로컬 우선 검색 레이어입니다. 이는 단순 키워드 매칭과 같은 단일 검색 방식에 의존할 때 발생하는 관련 결과 누락이나 과도한 노이즈 문제를 해결합니다. 여러 검색 기술을 결합함으로써, AI 에이전트가 대규모 코드베이스나 문서 세트에서 올바른 증거를 찾기 위해 필요한 도구 호출 횟수와 토큰 수를 줄여줍니다.

작동 방식

zg는 세 가지 서로 다른 검색 방법론을 단일 인터페이스로 통합합니다.

1. 벡터 검색 (Vector Search): 단순히 정확한 단어가 아닌 의미(의미론적 발견)를 기반으로 정보를 찾습니다.
2. BM25: 관련성을 보장하기 위한 어휘 검색용 랭킹 알고리즘입니다.
3. ripgrep: 검증을 위해 정확한 텍스트 또는 정규식 매칭을 제공합니다.

사용자는 작업 공간을 로컬에서 인덱싱할 수 있으며, 이 도구는 다양한 임베딩 모델(llama.cpp 또는 Transformers.js를 통한 로컬 모델 포함)을 지원하여 데이터가 기기 내에 유지되도록 합니다. 독립형 CLI 도구로 사용하거나, Model Context Protocol (MCP) 또는 특정 통합(예: OpenCode, Claude Code, Cursor)을 통해 AI 에이전트에 통합할 수 있습니다.

대상 사용자

• AI 에이전트 개발자: 복잡한 리포지토리를 탐색하여 아키텍처나 데이터 흐름 질문에 답해야 하는 에이전트를 구축하는 개발자.
• 개발자: 소스 코드, 문서, 구조화된 데이터를 위한 강력한 로컬 우선 검색 도구를 원하는 사람.
• 에이전트 워크플로우 사용자: Claude Code나 GitHub Copilot 같은 도구를 사용하며 AI 어시스턴트의 검색 품질을 향상시키려는 사용자.

주요 특징

• 하이브리드 검색: 의미론적 검색, 어휘 검색, 정규식 검색을 하나의 도구로 결합.
• 로컬 우선: 인덱스와 로컬 모델이 사용자 기기에 유지되어 개인정보 보호 및 보안을 보장.
• 에이전트 준비 완료: 에이전트에게 간결하고 순위가 매겨진 증거를 제공하도록 최적화되어 토큰을 절약하고 노이즈를 줄임.
• 다중 형식 지원: 소스 코드, 문서, 구조화된 데이터를 가로질러 검색할 수 있으며 소스 위치를 보존.
• 광범위한 통합: 서버 모드 또는 직접적인 CLI 액세스를 통해 다양한 AI 에이전트 및 IDE와 연동.