Skip to content
Back to search

codeseek

Rust-powered code intelligence CLI for AI coding agents. Builds call graphs and hybrid semantic search indexes (Dense + Sparse + RRF + Reranker) across 7 languages. Ships as native MCP tools for Claude Code and Codex CLI.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/CodeBendKit/codeseek with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/CodeBendKit/codeseek'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/codebendkit--codeseek/badge.svg)](/listings/codebendkit--codeseek)

HTML

<a href="/listings/codebendkit--codeseek"><img src="/api/listings/codebendkit--codeseek/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

# Install via npm (handles setup wizard + binary download automatically)
npm install -g codeseek

# First run — interactive setup wizard configures your embedding model
codeseek

# Index your project
codeseek init

# Search code by symbol name
codeseek search main --limit 10

# Query call graph
codeseek callers main
codeseek callees process_data

# Register with Claude Code / Codex as MCP tools
codeseek install

# Check status
codeseek status

# Auto-index on git commits
codeseek install-hooks

Natural Language Code Search example

╰─$ codeseek search 'how the code embedding work'
1. get_embedding (0.7973)
   /home/do/ssd/iohub/dev/codeseek/rust-core/src/services/embedding_service.rs:0
2. EmbeddingService (0.2855)
   /home/do/ssd/iohub/dev/codeseek/rust-core/src/services/embedding_service.rs:0
3. EmbeddingData (0.1449)
   /home/do/ssd/iohub/dev/codeseek/rust-core/src/services/embedding_service.rs:0
4. EmbeddingResponse (0.1304)
   /home/do/ssd/iohub/dev/codeseek/rust-core/src/services/embedding_service.rs:0
5. default_model (0.0450)
   /home/do/ssd/iohub/dev/codeseek/rust-core/src/config.rs:0

Function Call Graph example

╰─$ codeseek callgraph apply_rerank
Call graph for 'apply_rerank' (depth=1):

== Callers (upstream, depth=1) ==
  search (/home/do/ssd/iohub/dev/codeseek/rust-core/src/services/hybrid_search.rs:210)

== Callees (downstream, depth=1) ==
  rerank (/home/do/ssd/iohub/dev/codeseek/rust-core/src/services/reranker_service.rs:331)
  config (/home/do/ssd/iohub/dev/codeseek/rust-core/src/services/hybrid_search.rs:325)

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 343 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # CodeSeek
  2. **Code intelligence CLI tool for Claude Code.** AST-based call graph analysis + semantic search — right from your terminal.
  3. ## Quick Start
  4. ```bash
  5. # Install via npm (handles setup wizard + binary download automatically)
  6. npm install -g codeseek
  7. # First run — interactive setup wizard configures your embedding model
  8. codeseek
  9. # Index your project
  10. codeseek init
  11. # Search code by symbol name
  12. codeseek search main --limit 10
  13. # Query call graph
  14. codeseek callers main
  15. codeseek callees process_data
  16. # Register with Claude Code / Codex as MCP tools
  17. codeseek install
  18. # Check status
  19. codeseek status
  20. # Auto-index on git commits
  21. codeseek install-hooks
  22. ```
  23. Natural Language Code Search example
  24. ```bash
  25. ╰─$ codeseek search 'how the code embedding work'
  26. 1. get_embedding (0.7973)
  27. /home/do/ssd/iohub/dev/codeseek/rust-core/src/services/embedding_service.rs:0
  28. 2. EmbeddingService (0.2855)
  29. /home/do/ssd/iohub/dev/codeseek/rust-core/src/services/embedding_service.rs:0
  30. 3. EmbeddingData (0.1449)
  31. /home/do/ssd/iohub/dev/codeseek/rust-core/src/services/embedding_service.rs:0
  32. 4. EmbeddingResponse (0.1304)
  33. /home/do/ssd/iohub/dev/codeseek/rust-core/src/services/embedding_service.rs:0
  34. 5. default_model (0.0450)
  35. /home/do/ssd/iohub/dev/codeseek/rust-core/src/config.rs:0
  36. ```
  37. Function Call Graph example
  38. ```bash
  39. ╰─$ codeseek callgraph apply_rerank
  40. Call graph for 'apply_rerank' (depth=1):
  41. == Callers (upstream, depth=1) ==
  42. search (/home/do/ssd/iohub/dev/codeseek/rust-core/src/services/hybrid_search.rs:210)
  43. == Callees (downstream, depth=1) ==
  44. rerank (/home/do/ssd/iohub/dev/codeseek/rust-core/src/services/reranker_service.rs:331)
  45. config (/home/do/ssd/iohub/dev/codeseek/rust-core/src/services/hybrid_search.rs:325)
  46. ```
  47. ## Install
  48. ### npm
  49. ```bash
  50. npm install -g codeseek
  51. ```
  52. The npm package ships a lightweight JS wrapper that handles:
  53. | Step | Description |
  54. |------|-------------|
  55. | **First-run wizard** | Interactive CLI prompts for embedding API token, model, and base URL |
  56. | **Binary download** | Automatically pulls the correct Rust binary for your platform from GitHub Releases |
  57. | **Pass-through** | All commands (`init`, `search`, `callers`, etc.) are forwarded to the native binary |
  58. Supported platforms:
  59. | Platform | Architecture |
  60. |----------|-------------|
  61. | macOS | arm64 (Apple Silicon), x64 (Intel) |
  62. | Linux | x64 |
  63. ### Homebrew
  64. ```bash
  65. brew tap CodeBendKit/codeseek git@github.com:CodeBendKit/codeseek.git
  66. brew install codeseek
  67. ```
  68. ### From source
  69. ```bash
  70. # install protoc
  71. # macos: brew install protobuf
  72. # ubuntu: sudo apt install protoc
  73. git clone https://github.com/CodeBendKit/codeseek.git
  74. cd codeseek
  75. ./build.sh --release
  76. ```
  77. `build.sh` compiles both the TypeScript wrapper (`dist/`) and the Rust binary, then installs to `~/.codeseek/bin/`.
  78. ## Commands
  79. | Command | Description |
  80. |---------|-------------|
  81. | `codeseek` | First-time setup wizard (configures embedding model interactively) |
  82. | `codeseek init` | Build/update code index (full on first run, MD5-incremental thereafter) |
  83. | `codeseek status` | Index statistics: functions, files, last update |
  84. | `codeseek search <query>` | Symbol name search (falls back from vector → graph name match) |
  85. | `codeseek callers <symbol>` | Find functions that call this symbol |
  86. | `codeseek callees <symbol>` | Find functions this symbol calls |
  87. | `codeseek callgraph <symbol>` | Query call graph with configurable depth (bi-directional) |
  88. | `codeseek list` | List all indexed projects with paths |
  89. | `codeseek install` | Register codeseek as MCP tools in Claude Code / Codex |
  90. | `codeseek uninstall` | Remove MCP integration |
  91. | `codeseek uninit` | Delete the current project index |
  92. | `codeseek install-hooks` | Install git hooks (post-commit/post-merge → `codeseek init`) |
  93. | `codeseek serve --mcp` | Start MCP server (stdio JSON-RPC, used by Claude Code internally) |
  94. All query commands support `--json` for machine-readable output.
  95. ## Claude Code / Codex Integration
  96. ```bash
  97. codeseek install
  98. ```
  99. Writes MCP server config to:
  100. | Agent | Config file |
  101. |-------|------------|
  102. | **Claude Code** | `~/.claude.json` (global, all projects) or `./.mcp.json` (project-local) |
  103. | **Codex CLI** | `~/.codex/config.toml` |
  104. Claude Code auto-discovers these tools after restart:
  105. | Tool | Capability |
  106. |------|-----------|
  107. | `codeseek_search` | Find symbols by name |
  108. | `codeseek_callers` | Trace upstream callers |
  109. | `codeseek_callees` | Trace downstream callees |
  110. | `codeseek_callgraph` | Query call graph with configurable depth (bi-directional) |
  111. | `codeseek_status` | Check index health |
  112. Remove integration:
  113. ```bash
  114. codeseek uninstall
  115. ```
  116. ## How It Works
  117. ### Index Building (`codeseek init`)
  118. ```
  119. Source files
  120. → Tree-sitter AST parse (7 languages)
  121. → Extract functions / classes / methods
  122. → Batch embed via API (20 texts per call, SQLite cache)
  123. → Store vectors in LanceDB
  124. → Build BM25 index in Tantivy
  125. → Serialize call graph (PetCodeGraph)
  126. → Save to ~/.codeseek/<project_hash>/
  127. ```
  128. **Idempotent**: first run is full build, subsequent runs compare MD5 hashes — only changed files are re-processed. Use `codeseek install-hooks` for automatic re-index on git commit/merge.
  129. ### Hybrid Search Pipeline (`codeseek search`)
  130. ```
  131. ┌─────────────────────┐
  132. User query ────────────→│ Embedding Model │──→ Query vector
  133. └─────────────────────┘
  134. │
  135. ┌───────────────────────┼───────────────────────┐
  136. ▼ ▼ ▼
  137. ┌──────────────┐ ┌───────────────┐ ┌───────────────┐
  138. │ Dense Search │ │ Sparse Search │ │ Graph Search │
  139. │ (LanceDB ANN)│ │ (Tantivy BM25)│ │ (PetCodeGraph)│
  140. └──────┬───────┘ └──────┬────────┘ └────────┬──────┘
  141. │ │ │
  142. └──────────────────────┼────────────────────────┘
  143. ▼
  144. ┌─────────────────┐
  145. │ RRF Fusion │ ← Reciprocal Rank Fusion
  146. │ (Top-20 candidates)│
  147. └────────┬────────┘
  148. │
  149. ▼
  150. ┌─────────────────┐
  151. │ Reranker │ ← Cross-Encoder fine re-ranking
  152. │ (Qwen3-Reranker)│ scores each (query, code) pair
  153. └────────┬────────┘
  154. │
  155. ▼
  156. ┌─────────────────┐
  157. │ Final Results │ ← Top-5 (or Top-N)
  158. └─────────────────┘
  159. ```
  160. | Stage | Technology | Role | Speed |
  161. |-------|-----------|------|:-----:|
  162. | **Dense Search** | LanceDB + Embedding Model | Semantic vector similarity | Fast |
  163. | **Sparse Search** | Tantivy BM25 | Keyword & token matching | Fast |
  164. | **RRF Fusion** | Reciprocal Rank Fusion | Merge heterogeneous scores fairly | Instant |
  165. | **Reranker** | Cross-Encoder (Qwen3-Reranker-4B) | Full-interaction precision scoring | ~1-2s |
  166. | **Fallback** | PetCodeGraph | Graph-based name search (no API needed) | Instant |
  167. If embedding/Reranker are unavailable, the pipeline falls back gracefully to graph-based name search.
  168. ### Storage
  169. - **Config**: `~/.codeseek/config.json` (global, shared across all projects)
  170. - **Index**: `~/.codeseek/<md5(project_root)>/`
  171. - `project.json` — Project metadata
  172. - `graph.bin` — Serialized call graph
  173. - `embeddings.lance/` — LanceDB vector data
  174. - `tantivy_bm25/` — BM25 full-text index
  175. - `file_hashes.json` — MD5 incremental tracking
  176. No daemon, no HTTP server. Every command is a standalone process.
  177. ## Benchmarks
  178. End-to-end retrieval quality on public code-search benchmarks. Every number below is produced by
  179. the harnesses in [`evals/`](evals/) — measured, not estimated.
  180. | Benchmark | What it measures | Scale | Metric | Result |
  181. |-----------|------------------|-------|--------|:------:|
  182. | **[MTEB(Code, v1)](evals/mtebcode/)** | Natural language → function retrieval over real go / java / python source, plus CosQA | 101 tasks · 3,040 queries | nDCG@10 | **0.9182** |
  183. | **[RepoQA](evals/repoqa/)** | Repository-level localization inside a real codebase (needle in a haystack) | 10 repos · 5 languages · 100 tasks | accuracy | **84.0%** |
  184. **MTEB(Code)** — go `0.9448` · java `0.9101` · python `0.8994` · CosQA `0.9598`, with recall@10
  185. `0.9720` and MRR@10 `0.9004`: the right function is almost always retrieved, so what remains to win
  186. is rank-1 ordering rather than candidate generation.
  187. **RepoQA** — typescript `100%` · python `90%` · rust `90%` · java `85%` · cpp `55%`.
  188. ```bash
  189. # Full reproduction commands: evals/*/results/README.md
  190. cd evals/mtebcode && python3 -m mtebcode_eval prepare --tasks csn,CosQA
  191. cd evals/repoqa && python3 -m repoqa_eval prepare
  192. ```
  193. > Conditions: codeseek v0.1.31 with `Qwen/Qwen3-Embedding-4B`, `index.hybrid.cutoff.enabled = false`.
  194. > Full reports under [`evals/mtebcode/results/`](evals/mtebcode/results/) and
  195. > [`evals/repoqa/results/`](evals/repoqa/results/).
  196. ## Supported Languages
  197. | Language | Functions | Structs/Classes | Call Graph |
  198. |----------|:---------:|:---------------:|:----------:|
  199. | Rust | ✅ | ✅ | ✅ |
  200. | Python | ✅ | ✅ | ✅ |
  201. | JavaScript | ✅ | ✅ | ✅ |
  202. | TypeScript | ✅ | ✅ | ✅ |
  203. | Go | ✅ | ✅ | ✅ |
  204. | C/C++ | ✅ | ✅ | ✅ |
  205. | Java | ✅ | ✅ | ✅ |
  206. ## Configuration
  207. `~/.codeseek/config.json`:
  208. ```json
  209. {
  210. "embedding": {
  211. "provider": "openai-compatible",
  212. "model": "Qwen/Qwen3-Embedding-4B",
  213. "api_token": "sk-...",
  214. "api_base_url": "https://api.siliconflow.cn/v1",
  215. "dimensions": 2560,
  216. "instruct": "Given a code search query, retrieve relevant functions or code snippets that answer the query."
  217. },
  218. "index": {
  219. "min_code_block_length": 16,
  220. "enable_reranker": true,
  221. "hybrid": {
  222. "enable_bm25": true,
  223. "bm25_top_k": 20,
  224. "vector_top_k": 20,
  225. "rrf_k": 60,
  226. "rrf_top_k": 20
  227. },
  228. "reranker": {
  229. "enabled": true,
  230. "model": "Qwen/Qwen3-Reranker-4B",
  231. "api_token": "sk-...",
  232. "api_base_url": "https://api.siliconflow.cn/v1/rerank",
  233. "top_n": 5,
  234. "candidate_multiplier": 5,
  235. "timeout_secs": 60
  236. }
  237. },
  238. "installed_hooks": {}
  239. }
  240. ```
  241. > `embedding.instruct` — Qwen3-Embedding query-side instruction (asymmetric retrieval). Only the
  242. > search query gets the official `Instruct: {instruct}\nQuery:{query}` prefix; indexed code stays
  243. > raw, so existing vector indexes remain valid. Omit it to use the default shown above; set it to
  244. > `""` to turn the prefix off.
  245. ### Model Roles
  246. | Model | Role | When |
  247. |-------|------|------|
  248. | `Qwen/Qwen3-Embedding-4B` | Converts code → vectors for dense search | Index building |
  249. | `Qwen/Qwen3-Reranker-4B` | Scores (query, code) pairs for precision | Search time |
  250. Set via the interactive wizard on first run, or create manually.
  251. ## Development
  252. ```bash
  253. cd rust-core
  254. # Build
  255. cargo build
  256. # Build + install to ~/.codeseek/bin/
  257. cd .. && ./build.sh --release
  258. # Run tests
  259. cargo test
  260. # Compile TypeScript wrapper
  261. npm run build
  262. ```
  263. ## License
  264. MIT
  265. Built with: Tree-sitter · Petgraph · LanceDB · Tantivy · Tokio · Clap

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.