코드 구조를 이해하는 CLI 검색 도구, codespelunker!

codespelunker(cs)는 코드 구조를 이해하고 관련성 기반으로 검색 결과를 랭킹하는 CLI 도구로, 인덱싱 없이 작동한다.

기존 grep, ripgrep과 달리 코드, 주석, 문자열을 구분하여 검색 정확도를 높이고, BM25 알고리즘을 활용한 스마트 랭킹을 제공한다.

TUI, HTTP 서버, MCP 서버 등 다양한 인터페이스를 지원하며, Go, Python, JavaScript 등 다양한 언어를 지원한다.

ast-grep과 비교하여, codespelunker는 코드 구조 기반 검색에, ast-grep은 구조적 매칭에 강점을 가진다.

codespelunker의 핵심 기능: 구조적 이해와 스마트 랭킹

codespelunker(cs)는 구조적 이해(Structural Awareness)를 통해 코드 내에서 주석보다 코드에 있는 일치 항목에 더 높은 가중치를 부여한다. 또한, BM25 알고리즘을 활용하여 스마트 랭킹(Smart Ranking)을 수행하며, 파일 위치, 파일 길이, 코드 구조 등을 고려하여 검색 결과의 관련성을 높인다. 특히, --gravity 옵션을 통해 복잡성(Complexity)을 조절하여 복잡한 구현체를 우선적으로 검색할 수 있도록 지원한다.

기존 도구와의 차별점: ripgrep, ast-grep 비교

codespelunker(cs)는 ripgrep과 같은 빠른 텍스트 매칭 도구(Fast Text Matcher)와는 달리, 코드 구조를 이해하고 관련성 기반으로 결과를 랭킹한다. 또한, ast-grep과 비교했을 때, codespelunker는 코드 구조 기반 검색에, ast-grep은 구조적 매칭에 강점을 가진다. 즉, codespelunker는 '데이터베이스 마이그레이션 로직'과 같은 기능 중심의 검색(Function-Oriented Search)에, ast-grep은 '3개의 인자를 가진 함수'와 같은 에 더 적합하다.