ck

Appearance

ck ("seek")Hybrid Code Search

ck’s hybrid search fuses lexical (BM25/grep) precision with embedding-based recall and re-ranks both, so you find the right code even when the exact keywords aren’t there.

Get Started
View on GitHub
ck logo
⚡

Drop-in grep Replacement

All your muscle memory works. Same flags, same behavior, same output format — plus semantic understanding when you need it

🔍

Semantic Search

Find code by concept, not keywords. Search for “retry logic” and find backoff, circuit breakers, and related patterns even without exact matches

🎯

Hybrid Search

Combine keyword precision with semantic understanding using Reciprocal Rank Fusion for best-of-both-worlds search results

🤖

AI Agent Integration

Built-in MCP (Model Context Protocol) server for seamless integration with Claude Desktop, Cursor, and any MCP-compatible AI client

💻

Terminal User Interface

Interactive search with live results, visual score heatmaps, and keyboard-driven navigation. Explore code with TUI mode for instant feedback

🔌

Editor Integration

Native VSCode and Cursor extension. Search without leaving your editor with inline results, instant navigation, and live updates

🚀

Blazing Fast

~1M LOC indexed in under 2 minutes. Sub-500ms queries. Chunk-level incremental indexing only re-embeds what changed

📦

Completely Offline

Everything runs locally. No code or queries sent to external services. Embedding model downloaded once and cached locally

Quick Start ​

bash
# Install from NPM
npm install -g @beaconbay/ck-search

# CLI: Command-line search (grep-compatible)
ck --sem "error handling" src/
ck --hybrid "connection timeout" src/
ck -n "TODO" *.rs

# TUI: Interactive terminal UI
ck-tui
# Type queries, see live results, navigate with ↑/↓

# Editor: VSCode/Cursor extension
code --install-extension ck-search
# Press Cmd+Shift+; to search

# MCP: AI agent integration
ck --serve
# Configure in Claude Desktop for AI-assisted search

Why ck? ​

ck (seek) finds code by meaning, not just keywords. It’s the grep you wish you had:

  • 🎯 Understand intent – Search for “error handling” and find try/catch blocks, error returns, and exception handling even when those exact words aren’t present
  • 🤖 AI-first – Built-in MCP server for direct integration with AI coding assistants
  • ⚡ Fast & efficient – Automatic incremental indexing, sub-second queries
  • 🔧 Drop-in replacement – Works exactly like grep/ripgrep with all the flags you know
  • 🌐 Multi-language – Python, JavaScript/TypeScript, Rust, Go, Ruby, Haskell, C#, and more
  • 🔒 Privacy-first – 100% offline, no telemetry, no external API calls

Installation ​

bash
npm install -g @beaconbay/ck-search

From crates.io ​

bash
cargo install ck-search

From source ​

bash
git clone https://github.com/BeaconBay/ck
cd ck
cargo install --path ck-cli

Next Steps ​

Released under the MIT or Apache-2.0 License.

Copyright © 2025 BeaconBay