# ck - 로컬 퍼스트 시맨틱 & 하이브리드 BM25 grep/검색 도구

> Clean Markdown view of GeekNews topic #23507. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=23507](https://news.hada.io/topic?id=23507)
- GeekNews Markdown: [https://news.hada.io/topic/23507.md](https://news.hada.io/topic/23507.md)
- Type: news
- Author: [xguru](https://news.hada.io/@xguru)
- Published: 2025-10-08T09:31:02+09:00
- Updated: 2025-10-08T09:31:02+09:00
- Original source: [github.com/BeaconBay](https://github.com/BeaconBay/ck)
- Points: 5
- Comments: 0

## Summary

의미 기반 검색과 전통적 **키워드 기반 BM25 검색**을 결합해 코드 내에서 **동의어 및 개념 유사성**을 파악, 키워드가 명확하지 않아도 관련 **코드 블록**을 빠르게 찾을 수 있습니다. **MCP 서버** 아키텍처로 **Claude Desktop, Cursor** 등 다양한 에디터·도구와 연동되며, **시맨틱·정규표현식·하이브리드 모드**를 포함한 유연한 검색 옵션과 **1초 미만의 응답** 속도를 제공합니다. **grep 호환성**을 제공하며,  **JSON/JSONL 출력**, **프라이버시 중심 로컬 임베딩** 기반 설계를 바탕으로, 개발자와 **AI 에이전트 자동화** 모두에 최적화된 검색 인프라를 구축하는데 적합합니다.

## Topic Body

- 코드의 **의미 기반 검색**과 전통적 키워드 검색을 결합, 키워드가 없어도 **동의어·개념 유사성**을 통해 **관련 코드 블록**을 찾아주는 로컬 퍼스트 검색 도구  
  - “error handling” 을 검색하면 **try/catch, 예외 처리, 인증 흐름**을 식별하는 **시맨틱 매칭 기능** 제공  
- **MCP 서버**로 동작해 Claude Desktop, Cursor 등과 연동되며, **semantic/regex/hybrid** 등 다양한 툴과 **페이지네이션**을 제공  
- **자동 델타 인덱싱**과 **스마트 파일 제외 규칙**으로 대규모 저장소에서도 **1초 미만 응답**과 경량 인덱스 유지가 가능  
- **grep 호환 플래그**와 **JSON/JSONL 출력**을 지원해 인간 사용과 **AI 에이전트 자동화** 파이프라인 모두에 적합  
- 로컬 임베딩과 캐시를 활용하는 **프라이버시 중심 설계**로 코드 유출 없이 **에이전트 통합 검색 인프라**를 구축하는데 유용   
- ck의 발음은 `seek`

## Comments



_No public comments on this page._