Search for code in a dependency

codedb_remote repo="justrach/merjs" action="search" query="handleRequest"

Check dependency CVE evidence; scope can be runtime or all

codedb_remote repo="axios/axios" action="cves" scope="runtime"

⚡ Install

curl -fsSL https://codedb.codegraff.com/install.sh | bash

Downloads the binary for your platform and auto-registers codedb as an MCP server in Claude Code, Codex, Gemini CLI, Cursor, Windsurf, and Devin — each written directly and additively into that tool's config (only when the tool is present). The installer prints the exact codedb mcp command it registered plus hook setup pointers for Codex and Claude Code.

Or via npm/npx (zero-install for MCP clients)

npx -y codedeebee mcp

Or install globally:

npm install -g codedeebee
codedb mcp

The npm package is named codedeebee (the bare codedb name is restricted on npm); it ships a thin launcher that downloads the matching native binary from GitHub Releases on postinstall and verifies the SHA256 checksum. The installed CLI is still called codedb.

Useful for MCP clients (Claude Code, Cursor, opencode, Claude Desktop) that already use npx:

{
  "codedb": {
    "type": "local",
    "command": ["npx", "-y", "codedeebee"],
    "args": ["mcp"],
    "enabled": true
  }
}

Updating or repairing an older install

If codedb update fails on an older release, rerun the installer:

curl -fsSL https://codedb.codegraff.com/install.sh | bash

This replaces the codedb binary with the latest GitHub Release and keeps your existing MCP registrations, config, caches, and snapshots. Use this path for any release whose built-in updater cannot fetch release checksums.

Manual MCP start (auto-configured by install script)

codedb mcp /path/to/your/project ```

🔨 Building from Source

Requirements: Zig 0.16+

git clone https://github.com/justrach/codedb.git
cd codedb
zig build                              # debug build
zig build -Doptimize=ReleaseFast       # release build
zig build test                         # run tests
zig build bench                        # run benchmarks

Binary: zig-out/bin/codedb

⚡ Quick Start

Example: agent explores a codebase

```bash

Background Resource Usage (`openclaw`, 6,315 files, Apple M4 Pro)

The watcher now stats .git/HEAD mtime before forking git rev-parse HEAD. On an idle repo the subprocess never fires.

CLI Commands

Options: --no-telemetry (or set CODEDB_NO_TELEMETRY env var)

Latency — codedb MCP vs codedb CLI vs ast-grep vs ripgrep vs grep

codedb repo (20 files, 12.6k lines):

merjs repo (100 files, 17.3k lines):

rtk-ai/rtk repo (329 files) — codedb vs rtk vs ripgrep vs grep: