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