BC

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

1.1천 stars 23 forks 품질 76 트렌드 43MIT

codespelunker - 코드 구조를 이해하고 관련성에 따라 결과를 순위 매기는 CLI 코드 검색 도구입니다. CLI, TUI, MCP, HTTP 지원으로 인덱싱이 필요 없습니다.

개요

CS 파워 searchcode.com — AI 에이전트를 위해 구축된 어떤 저장소에도 구조화된 코드 인텔리전스입니다. authenticate를 검색하다가 설정 파일, 주석, 테스트 스텁에서 200개의 결과가 나오다가 실제 구현을 찾으신 적 있나요? CS가 그 문제를 해결해 줍니다. 이 도구는 CLI 도구의 속도와 Sourcegraph나 Zoekt 같은 무겁게 색인화된 검색 엔진에만 적용되는 관련성 순위를 결합하지만, 색인을 유지할 필요가 없습니다. [//]: # ([! [asciicast](https://asciinema.org/a/589640.svg)](https://asciinema.org/a/589640)) https://github.com/user-attachments/assets/3b7f4bb2-d542-406d-9c53-29c0430dd60a 대부분의 검색 도구는 코드를 일반 텍스트로 취급합니다. CS는 그렇지 않습니다. 모든 파일을 실시간으로 파싱하여 무엇이 주석인지, 무엇이 문자열인지, 무엇이 코드인지 파악한 후, 그 구조를 사용해 단순히 발생 횟수별로 나열하는 것이 아니라 관련성에 따라 순위를 매깁니다. 인터랙티브 탐험을 위한 TUI와 HTTP 모드가 포함되어 있습니다.

개요(AI 번역)

CS는 searchcode.com — 어떤 저장소보다 구조화된 코드 인텔리전스를 AI 에이전트용으로 구현합니다.

CLI 코드 검색 도구는 코드 구조를 이해하고 관련성에 따라 결과를 순위 매깁니다. 인덱싱이 필요 없습니다

authenticate를 검색해서 설정 파일, 주석, 테스트 스텁에서 200개의 결과가 나온 적이 있나요? 실제 구현을 찾기 전에요. cs가 그걸 해결해줍니다.

이는 CLI 도구의 속도와 보통 무거운 색인 검색 엔진에만 허용되는 관련성 순위를 결합한 것입니다 Sourcegraph나 Zoekt처럼 인덱스를 유지할 필요가 없었습니다.

MIT 라이선스 소속입니다.

[//]: # ([! asciicast

CS TUI 데모

피치: 왜 CS를 사용할까요?

대부분의 검색 도구는 코드를 평문으로 취급합니다. cs는 그렇지 않습니다.

모든 파일을 실시간으로 파싱하여 무엇이 주석인지, 무엇이 문자열인지, 무엇이 코드인지 구분합니다 그 구조를 사용해 단순히 발생 횟수별로 나열하는 것이 아니라 관련성에 따라 순위를 매깁니다.

인터랙티브 탐험을 위한 TUI와 HTTP 모드가 포함되어 있습니다.

ripgrep이나 grep과 뭐가 다른가요?

ripgrep는 빠른 텍스트 매처입니다. 줄을 찾아서 출력합니다. 이 기능은 이 분야에서 최고입니다.

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

codespelunker (cs)

cs powers searchcode.com — structured code intelligence over any repo, built for AI agents.

CLI code search tool that understands code structure and ranks results by relevance. No indexing required

Ever searched for authenticate and gotten 200 results from config files, comments, and test stubs before finding the actual implementation? cs fixes that.

It combines the speed of CLI tools with the relevance ranking usually reserved for heavy indexed search engines like Sourcegraph or Zoekt, but without needing to maintain an index.

cs "authenticate" --gravity=brain           # Find the complex implementation, not the interface
cs "FIXME OR TODO OR HACK" --only-comments  # Search only in comments, not code or strings
cs "error" --only-strings                   # Find where error messages are defined
cs "handleRequest" --only-declarations      # Jump straight to where it's defined
cs "handleRequest" --only-usages            # Find every call site, skip the definition
cs "error" --dedup                          # Collapse duplicated matches into one result

Licensed under MIT.

cs TUI demo

Pitch: Why use cs?

Most search tools treat code as plain text. cs doesn’t.

It parses every file on the fly to understand what is a comment, what is a string, and what is code then uses that structure to rank by relevance, not just list them by occurrence.

cs "authenticate"                    # BM25-ranked variant results, best match first
cs "authenticate" --gravity=brain    # Boost complex implementations over interfaces
cs "TODO" --only-comments            # Only matches inside comments
cs "error" --only-strings            # Only matches inside string literals
cs "config OR setup" lang:go         # Boolean queries with language filters
cs "handleRequest" --only-declarations  # Jump to definitions (func, class, def, etc.)
cs "config" --dedup                     # Collapse byte-identical matches

It comes with a TUI and HTTP mode for Interactive Exploration.

cs      # enter TUI mode from this location
cs -d   # enter HTTP mode on port 8080 by default

What makes it different from ripgrep or grep?

ripgrep is a fast text matcher. It finds lines and prints them. It’s the best at what it does.

cs is a search engine. It finds files, ranks by relevance, extracts the best snippet, and shows the most relevant results. Think Sourcegraph-quality ranked search as a CLI tool, no index required.

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "codespelunker": { "command": "/path/to/cs", "args": ["--mcp", "--dir", "/path/to/codebase"] } } }