Skip to content

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.

ck logo

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.