grepai

grepai는 시맨틱 코드 검색을 위한 오픈소스 CLI로, 개발자 Yoan Bernabeu가 만들고 MIT 라이선스로 공개했다. 이름은 1973년의 원조 grep에 대한 오마주지만, 발상은 다르다. 고전적인 grep은 텍스트 패턴을 대응시킨다. grepai는 함수와 클래스를 벡터로 변환해 의미를 대응시킨다. 그래서 "error handling"을 검색하면 catchException이라는 함수가 떠오른다. 그런 이름을 입력할 생각은 못 했을 것이다.

이 도구는 두 부류를 위해 만들어졌다. 첫째는 큰 리포지토리에서 심볼 이름을 추측하는 데 지친 개발자다. 둘째는 AI 코딩 에이전트로, 무언가를 이해하기 전에 grep과 파일 재독으로 많은 토큰을 태운다. 에이전트에 원시 검색 출력이 아니라 관련 코드의 짧은 목록을 건네면, grepai는 그 에이전트가 필요한 입력 토큰을 줄인다. r/ClaudeAI 사용자들이 바로 그렇게 보고했다. 한 개발자는 Claude Code의 입력 토큰이 크게 줄었다고 말했다.

가장 큰 제약은 설정이다. grepai는 코드를 벡터로 바꿀 임베딩 제공자가 필요하다. 즉 Ollama를 설치하고 모델을 받거나, 클라우드 제공자의 API 키를 넘겨야 한다. 한 번 실행하고 잊어버리는 명령이 아니다. 저사양 기기에서는 큰 리포지토리의 첫 인덱싱에도 시간이 걸린다. 터미널에서 사는 개발자에게는 공정한 거래다. 그 외의 사람에게는 아마 원하는 것보다 많은 기계 장치다.

시작하기

1. 운영체제에 맞는 한 줄 스크립트로 grepai를 설치하거나, macOS에서는 Homebrew를 쓴다. Windows에서는 GitHub 페이지에서 PowerShell 명령을 받는다.
2. Ollama용 임베딩 모델을 받는다. 보통 nomic-embed-text다. 로컬 임베딩은 코드를 내 컴퓨터에 붙잡아 둔다.
3. 프로젝트 안에서 grepai init을 실행해 설정을 만들고 인덱스를 준비한다.
4. grepai watch를 시작하면 파일 감시자가 편집하는 동안 인덱스를 최신으로 유지한다.
5. grepai search "error handling"으로 평이한 영어로 검색하거나, grepai trace callers "Login"으로 관계를 추적한다.