# boyter/cs

codespelunker - CLI code search tool that understands code structure and ranks results by relevance. No indexing required with CLI, TUI, MCP and HTTP support.

Repository: https://github.com/boyter/cs
Canonical: https://ross.abutalabs.com/products/cs
Language: Go
License: MIT
License Family: permissive
Topics: search, code, command-line-tool, cli, tui
Last push: 2026-09-03T01:50:13+00:00

## Health v2 (maintenance only)
Score: 91/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 100, release rhythm 73, longevity 100
- inputs: {"age_days": 2596, "days_push": 0, "days_rel": 182, "gap_med": 7.5, "n_releases_24m": 3}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1063, forks 23 (observed 2026-09-03T02:15:09.660486+00:00)

## What it is
codespelunker (cs) is a CLI code search tool written in Go that parses code on the fly to understand structure (comments, strings, declarations) and ranks results by relevance without requiring an index. It offers CLI, TUI, HTTP, and MCP interfaces and powers searchcode.com.

## Use cases
- search code for implementations instead of config or comments
- find where a function is defined or used
- search only inside comments or string literals
- rank code search results by relevance without maintaining an index
- explore a codebase interactively via TUI or HTTP
- give AI agents structured code search via MCP

## When to choose
- you need relevance-ranked code search without building or maintaining an index
- you want to filter matches by code structure like comments, strings, or declarations
- you want a search tool that also serves TUI, HTTP, or MCP interfaces

## When to avoid
- you only need fast plain-text line matching, where ripgrep or grep is simpler and faster
- you need a persistent indexed search service across many large repositories

## Facets
- artifact type: cli-tool
- maturity: active
- function: search-engine, cli, parser
- domain: developer-tools
- platform: cli, cross-platform, go
- tags: code-search, tui, mcp, http-server, no-indexing, relevance-ranking, bm25, search, command-line

## Member repositories
- boyter/cs (main) score 91

## Provenance
- Observed fields: from GitHub, fetched 2026-09-03T02:15:09.660486+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:56:55.298088+00:00, confidence not recorded.
  - readme: https://github.com/boyter/cs (fetched 2026-09-03T02:15:09.660486+00:00, sha 76cb82cc75c0)
- Data as of 2026-08-30T08:39:29.467469+00:00.