grepai

의미 기반 코드 검색

텍스트 패턴이 아닌 의도를 기반으로 검색합니다. ‘사용자 인증 흐름’을 검색하면 관련 함수와 로직을 정확히 찾아줍니다. 파일 이름 지정 방식이 달라도 개념적으로 관련된 코드를 찾을 수 있습니다.

호출 그래프 추적

함수가 누구에 의해 호출되는지, 무엇을 호출하는지 추적할 수 있습니다. 코드를 변경하기 전에 영향 범위를 파악하고 리팩토링을 자신 있게 진행할 수 있습니다.

실시간 인덱싱

파일 감atcher가 코드 변경 시 인덱스를 자동으로 업데이트하여 항상 최신 상태를 유지합니다. 수동 리인덱싱 없이 바로 검색할 수 있습니다.

AI 에이전트 통합

MCP 서버를 통해 Claude Code, Cursor, Windsurf 등과 네이티브로 통합됩니다. JSON 출력을 지원하여 다양한 AI 도구와 원활하게 작동합니다.

Windows 설치

PowerShell에서 다음 명령을 실행하여 설치합니다: irm https://raw.githubusercontent.com/yoanbernabeu/grepai/main/install.ps1 | iex

프로젝트 초기화 및 검색

프로젝트 디렉토리에서 다음 순서로 사용합니다:

• grepai init: 현재 프로젝트를 초기화합니다
• grepai watch: 인덱싱 데몬을 시작합니다
• grepai search "에러 처리": 자연어로 시맨틱 검색을 수행합니다
• grepai trace callers "Login": 특정 함수의 호출자를 추적합니다

이런 경우에 유용합니다

대규모 코드베이스 탐색: 익숙하지 않은 코드베이스에서 특정 기능의 구현 위치를 빠르게 찾고 싶을 때 유용합니다. 자연어 질문으로 관련 코드를 발견할 수 있습니다.

AI 코딩 에이전트 최적화: Claude Code나 Cursor를 사용할 때 관련 맥락만 제공하여 토큰 사용량을 줄이고 AI의 작업 효율성을 높입니다.

리팩토링 전 영향 분석: 함수를 변경하기 전에 누가 이 함수를 호출하고 있는지 파악하여 안전하게 리팩토링을 진행할 수 있습니다.

지원 환경

Windows, macOS, Linux를 모두 지원합니다. 100% 로컬에서 작동하여 코드가 외부로 유출되지 않는 프라이버시 보호 기능을 제공합니다. Ollama, LM Studio, OpenAI 중 선택하여 임베딩을 생성할 수 있습니다.

최신 버전

현재 버전 0.37.0은 MIT 라이선스로 배포되며, Go 언어로 작성된 단일 바이너리 파일입니다. 의존성 없이 빠르게 설치 및 실행할 수 있습니다.

제한 사항·확인 사항

임베딩 생성을 위해 Ollama, LM Studio 또는 OpenAI 계정과 API 키가 필요합니다. Ollama는 로컬에서 완전히 오프라인으로 작동하는 권장 옵션입니다.