cs – 인덱스 없이 코드 구조를 이해하는 코드 검색 도구 (코드/주석/문자열 구분 랭킹)

뭐가 다른가

• ripgrep이 빠른 텍스트 매처라면, cs는 검색 엔진임. 파일을 찾고, 관련도로 순위를 매기고, 가장 관련성 높은 스니펫을 추출함. Sourcegraph 수준의 랭킹을 인덱스 없이 CLI로 돌린다고 보면 됨 (MIT 라이선스)

• 핵심 차별점은 구조 인식(Structural Awareness). 모든 파일을 온더플라이로 파싱해서 코드/주석/문자열을 구분함:

  • 코드 내 매치: 가중치 1.0
  • 문자열 내 매치: 0.5
  • 주석 내 매치: 0.2
  • --only-code, --only-comments, --only-strings로 필터링도 가능

• 복잡도 중력(Complexity Gravity) 기능이 재밌음. 순환 복잡도(cyclomatic complexity)를 랭킹 시그널로 사용해서, Authenticate를 검색하면 인터페이스 정의보다 실제 로직이 구현된 복잡한 파일이 상위에 옴

랭킹 시스템

• 가중 BM25 알고리즘 기반. 코드/주석/문자열을 "필드"로 취급해서 필드별 가중치 적용. 파일 길이 감쇠, 테스트 파일 하향, 노이즈 페널티도 들어감

• 프리셋 프로파일 3종:

  • balanced (기본): 표준 BM25, 적당한 복잡도 부스트
  • precise: "딱 그 파일 하나"를 찾을 때 — TF 빠르게 포화, 긴 파일 페널티, 테스트 파일 공격적 필터링
  • broad: "관련된 건 다 보여줘" — 반복 매치 보상, 테스트 파일 포함

• Gravity 플래그로 복잡도 부스트 강도 조절: brain(2.5, 복잡한 핵심 로직 공격적 서피싱) → logic(1.5) → default(1.0) → low(0.2) → off(0.0, 순수 텍스트 관련도)

• 선언문 감지(declaration detection)도 지원해서 func, class, def 같은 줄의 매치를 일반 사용 매치보다 부스트함. Go, Python, JS, TS, Rust, Java, C/C++/C# 등 30개 이상 언어 지원

성능과 인터페이스

• 인덱스가 전혀 없고 전부 브루트포스 계산인데도, Apple Silicon M1에서 리눅스 커널 전체를 ~3초에 검색, 9950X3D에서는 ~400ms라고 함

• 콘솔 출력, 내장 TUI, HTTP 서버(구문 하이라이팅), MCP 서버(Claude Desktop, Claude Code, Cursor 등 LLM 도구에 연결 가능) 네 가지 인터페이스 제공

• 바이트 단위 동일 매치를 하나로 접어주는 중복 제거, fzf처럼 TUI에서 결과 선택 후 Enter로 파일 경로 반환하는 기능도 있음