boyter/cs

어떤 프로젝트인가요?

핵심 기능

• 01코드, 주석, 문자열 리터럴을 구분하는 구조 인식 매칭
• 02복잡도 기반 gravity 및 파일 위치 부스트를 적용한 BM25 관련도순 정렬
• 03정의나 호출 위치로 이동할 수 있는 선언 및 사용처 필터
• 04불리언 쿼리, 따옴표로 묶은 구문, 정규식, 퍼지 매칭
• 05콘솔, TUI, HTTP 서버, MCP 인터페이스
• 06검색 디렉터리의 저장소를 주기적으로 git pull

활용 사례

• 인터페이스, 테스트 또는 주석이 아닌 실제 함수 구현 찾기
• 프로젝트 전체에서 TODO/FIXME 주석이나 오류 메시지 문자열만 검색하기
• MCP를 통해 LLM 에이전트에 관련도순 코드 검색 도구 제공하기
• 검색 서버를 유지 관리하지 않고 클론한 저장소 디렉터리 검색하기

빠른 시작

1. 1

   Go로 설치(Go 1.25.2 이상 필요)

   go install github.com/boyter/cs/v3@latest
2. 2

   어떤 디렉터리에서든 검색 실행

   cs "authenticate" --gravity=brain

사용 전 알아둘 점

• !go install 방식으로 설치하려면 Go 1.25.2 이상이 필요합니다. 다른 방식으로 설치하려면 releases 페이지에서 바이너리를 받으세요.
• !인덱스가 없어 검색할 때마다 일치하는 파일을 모두 스캔하므로, 일반 텍스트 검색에서는 ripgrep보다 느립니다.

토픽

자주 묻는 질문

cs은(는) 무엇인가요?

코드 구조를 분석해 관련도순으로 결과를 정렬하는, 인덱스가 필요 없는 CLI 코드 검색 도구입니다. cs (codespelunker)는 Go로 작성된 커맨드라인 코드 검색 도구입니다. 검색된 각 파일을 실시간으로 분석해 코드, 주석, 문자열을 구분하고, 텍스트가 일치하는 항목을 모두 나열하는 대신 구조적 가중치를 적용한 BM25 관련도순으로 결과를 정렬합니다. 미리 인덱싱할 필요가 없어 어떤 디렉터리든 지정해 바로 검색할 수 있습니다.

cs은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

cs은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

cs은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. cs의 마지막 커밋은 2026년 10월 20일입니다.

cs은(는) 어디에 사용할 수 있나요?

인터페이스, 테스트 또는 주석이 아닌 실제 함수 구현 찾기 프로젝트 전체에서 TODO/FIXME 주석이나 오류 메시지 문자열만 검색하기 MCP를 통해 LLM 에이전트에 관련도순 코드 검색 도구 제공하기 검색 서버를 유지 관리하지 않고 클론한 저장소 디렉터리 검색하기

cs는 어떻게 설치하나요?

Go로 설치(Go 1.25.2 이상 필요): go install github.com/boyter/cs/v3@latest 어떤 디렉터리에서든 검색 실행: cs "authenticate" --gravity=brain

cs은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/boyter/cs