codedb

Overview of codedb

What it is

codedb is a code intelligence server and MCP toolset written in Zig, designed for AI agents. It provides fast file tree, outline, symbol, search, read, edit, dependency, snapshot, and remote GitHub repository queries. codedb is a context engine, not an editor; it works with MCP clients such as Graff, Claude Code, Codex, Gemini CLI, Cursor, Windsurf, Devin, oh-my-pi, Hermes, Qwen Code, ZCode, Trae, Cline, Copilot CLI, Antigravity, Kiro, OpenCode, and others.

Key features

• Fast file tree, outline, symbol definitions, callers, dependency graphs, trigram search, and portable snapshots.
• Parsers for Zig, C/C++, Python, TypeScript/JavaScript, Rust, Go, PHP, Ruby, HCL, R, Dart/Flutter, and OCaml; more languages have lightweight outlines.
• Bounded OS watches with periodic content verification for live updates.
• Structural search runs locally; default hybrid retrieval uses hosted embeddings, with an option for local-only retrieval.
• MCP tools: context, explain, callpath, list_dir, status, and more.
• Binaries for macOS (ARM64 and x86_64, signed and notarized), Linux (ARM64 and x86_64), and Windows (x86_64, SHA256 verified).
• Installable via shell script, PowerShell, or npm (package name codedeebee).

Use cases

• Find relevant files and source excerpts for a task using codedb_context.
• Read a function definition and its callers with codedb_explain.
• Trace a chain between symbols with codedb_callpath.
• Browse repository directories and inspect file outlines with codedb_list_dir.
• Perform full-text search (trigram-accelerated) and exact word lookup.

Getting started

bash # Install on macOS/Linux curl -fsSL https://codedb.codegraff.com/install.sh | bash # Install on Windows (PowerShell) irm https://raw.githubusercontent.com/justrach/codedb/v0.2.5841/install/install.ps1 | iex # Install via npm npx -y codedeebee mcp # Start as MCP server codedb mcp /path/to/your/project # Start as HTTP server codedb serve /path/to/your/project # CLI examples codedb tree /path/to/project codedb outline src/main.zig codedb find AgentRegistry codedb search handleAuth

License and pricing

License: BSD-3-Clause. Pricing: open source (free).

Based on the project's public README and repository metadata.