Repolode
제출하기
yoanbernabeu

yoanbernabeu/grepai

로컬 임베딩, 호출 그래프 추적, AI 코딩 에이전트용 MCP 서버를 지원하는 프라이버시 우선 CLI 시맨틱 코드 검색 도구입니다.

GitHub에서 보기웹사이트
스타
1,940
포크
160
열린 이슈
81
마지막 커밋
6일 전

어떤 프로젝트인가요?

grepai는 정확한 텍스트가 아니라 의미를 기준으로 코드베이스를 검색하는 명령줄 도구입니다. 임베딩을 사용해 코드의 벡터 인덱스를 구축하므로, "사용자 인증 흐름"처럼 자연어로 질의하면 함수 이름이 달라도 관련 함수를 찾을 수 있습니다.

이 도구는 사용자의 컴퓨터에서만 실행되며 Ollama 같은 로컬 임베딩 제공자를 사용할 수 있고, LM Studio와 OpenAI도 지원합니다. 백그라운드 파일 감시자가 파일 변경 사항을 반영해 인덱스를 최신 상태로 유지합니다. 호출 그래프 추적 기능도 제공하므로 함수를 수정하기 전에 해당 함수를 호출하는 코드를 확인할 수 있습니다.

grepai는 MCP 서버로도 동작해 Claude Code, Cursor, Windsurf 같은 AI 에이전트가 도구로 호출할 수 있습니다. 프로젝트 설명에 따르면, 에이전트가 원시 검색 결과 대신 필요한 맥락만 전달받으므로 코드 내용을 읽는 데 사용하는 입력 토큰을 줄일 수 있습니다.

핵심 기능

  • 01정확한 텍스트가 아니라 의도를 기준으로 코드를 찾는 시맨틱 검색
  • 02함수의 호출자를 찾는 호출 그래프 추적
  • 03Ollama, LM Studio 또는 OpenAI 임베딩을 사용하는 완전한 로컬 실행
  • 04인덱스를 자동으로 최신 상태로 유지하는 파일 감시자
  • 05AI 에이전트에서 grepai를 호출할 수 있는 MCP 서버

활용 사례

  • Claude Code나 Cursor가 파일 전체를 읽지 않고도 관련 코드를 찾도록 하기
  • 정확한 함수 이름을 모를 때 개념을 바탕으로 코드 찾기
  • 리팩터링 전에 함수의 호출자 확인하기
  • 외부 서비스에 코드를 전송하지 않고 비공개 코드베이스 검색하기

빠른 시작

  1. 1

    Homebrew로 설치(macOS)

    brew install yoanbernabeu/tap/grepai
  2. 2

    임베딩 제공자 설치: Ollama 모델 nomic-embed-text를 pull

    ollama pull nomic-embed-text
  3. 3

    프로젝트에서 grepai를 초기화한 다음 인덱싱 데몬 시작

    grepai init && grepai watch
  4. 4

    의미를 기준으로 코드 검색

    grepai search "error handling"

사용 전 알아둘 점

  • Ollama, LM Studio, OpenAI와 같은 별도의 임베딩 제공자가 필요합니다.
  • README에서는 Linux와 Windows 설치 시 패키지 관리자가 아닌 curl 또는 PowerShell 설치 스크립트를 사용합니다.

포함된 컬렉션

Claude Code용 MCP 서버Claude Code 도구·스킬·플러그인AI 코딩 어시스턴트와 에이전트MCP 서버CLI·터미널 도구

토픽

#code-search#semantic-search#embeddings#mcp#cli#vector-search#developer-tools#ai#claude-code#cursor

자주 묻는 질문

grepai은(는) 무엇인가요?
로컬 임베딩, 호출 그래프 추적, AI 코딩 에이전트용 MCP 서버를 지원하는 프라이버시 우선 CLI 시맨틱 코드 검색 도구입니다. grepai는 정확한 텍스트가 아니라 의미를 기준으로 코드베이스를 검색하는 명령줄 도구입니다. 임베딩을 사용해 코드의 벡터 인덱스를 구축하므로, "사용자 인증 흐름"처럼 자연어로 질의하면 함수 이름이 달라도 관련 함수를 찾을 수 있습니다.
grepai은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
grepai은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
grepai은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. grepai의 마지막 커밋은 2026년 11월 2일입니다.
grepai은(는) 어디에 사용할 수 있나요?
Claude Code나 Cursor가 파일 전체를 읽지 않고도 관련 코드를 찾도록 하기 정확한 함수 이름을 모를 때 개념을 바탕으로 코드 찾기 리팩터링 전에 함수의 호출자 확인하기 외부 서비스에 코드를 전송하지 않고 비공개 코드베이스 검색하기
grepai는 어떻게 설치하나요?
Homebrew로 설치(macOS): brew install yoanbernabeu/tap/grepai 임베딩 제공자 설치: Ollama 모델 nomic-embed-text를 pull: ollama pull nomic-embed-text 프로젝트에서 grepai를 초기화한 다음 인덱싱 데몬 시작: grepai init && grepai watch 의미를 기준으로 코드 검색: grepai search "error handling"
grepai은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/yoanbernabeu/grepai

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트