# BeaconBay/ck

Local first semantic and hybrid BM25 grep / search tool for use by AI and humans!

Repository: https://github.com/BeaconBay/ck
Canonical: https://ross.abutalabs.com/products/beaconbay-ck
Homepage: https://beaconbay.github.io/ck/
Language: Rust
License: Apache-2.0
License Family: permissive
Topics: grep, grep-like, rust, semantic
Last push: 2026-08-13T06:50:06+00:00

## Health v2 (maintenance only)
Score: 79/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 97, release rhythm 85, longevity 26
- inputs: {"age_days": 368, "days_push": 20, "days_rel": 101, "gap_med": 0.0, "n_releases_24m": 23}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1705, forks 70 (observed 2026-08-28T04:05:24.774852+00:00)

## What it is
ck is a grep-compatible code search tool written in Rust that combines traditional BM25/regex search with local embedding-based semantic search and hybrid rank fusion. It runs entirely offline, includes an interactive TUI, a VSCode/Cursor extension, and a built-in MCP server for AI agent integration.

## Use cases
- search code by meaning instead of exact keywords
- find error handling patterns without matching literal strings
- grep-compatible replacement with semantic fallback
- give AI coding agents fast local code search via MCP
- interactively explore a codebase in a terminal UI
- index a large codebase locally without sending code to the cloud

## When to choose
- you want grep-like search that also understands concepts and synonyms
- you need fully offline, privacy-preserving code search
- you want to wire semantic code search into Claude Desktop, Cursor, or other MCP clients
- you work in the terminal and want a TUI for exploring code

## When to avoid
- you only need exact regex matching and want zero index overhead
- you need cloud-hosted or team-shared code search
- your environment cannot run a local embedding model

## Facets
- artifact type: cli-tool
- maturity: active
- function: search-engine, cli, mcp, terminal-ui, rag
- domain: developer-tools, artificial-intelligence
- platform: cli, cross-platform, rust, editor-plugin
- tags: semantic-search, grep, bm25, hybrid-search, embeddings, code-search, offline, vscode-extension, command-line, search, ai-agents

## Member repositories
- BeaconBay/ck (main) score 79

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:24.774852+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-30T03:37:30.781438+00:00, confidence not recorded.
  - readme: https://github.com/BeaconBay/ck (fetched 2026-08-28T04:05:24.774852+00:00, sha e95e114ab246)
  - homepage: https://beaconbay.github.io/ck/ (fetched 2026-08-29T11:11:38.268741+00:00, sha f223e3fe4c70)
- Data as of 2026-08-30T08:39:29.467469+00:00.