codedb
codedb is a code intelligence server written in Zig that indexes codebases for fast structural search, symbol lookup, and dependency analysis. It operates as an MCP (Model Context Protocol) server to provide AI agents with code context without editing capabilities.
Key facts
Objective fields from the source. Values we can't verify are shown as “Unknown” rather than guessed.
| Field | Value |
|---|---|
| Repository | justrach/codedb |
| Owner | justrach |
| Primary language | Zig |
| License | BSD-3-Clause — OSI-approved |
| Stars | 1.3k |
| Forks | 79 |
| Open issues | 9 |
| Latest release | v0.2.5828 (2026-07-05) |
| Last updated | 2026-07-06 |
| Source | https://github.com/justrach/codedb |
What codedb is
A Zig-based indexing engine using trigram-accelerated full-text search, inverted word indexes, and structural parsing for 21 languages. Exposes 21 MCP tools over JSON-RPC 2.0 stdio, with optional HTTP API on localhost:7719, file watching, and atomic line-range edits as a fallback mechanism.
Get the codedb source
Clone the repository and explore it locally.
git clone https://github.com/justrach/codedb.gitcd codedb# follow the project's README for install & configurationNeed it deployed, integrated, or customized instead? DEV.co ships production installs.
Best use cases
Implementation considerations
- MCP registration is automated by installer for Claude, Cursor, Gemini, Codex, Windsurf, Devin; verify integration in each tool's config file after install.
- Requires Zig 0.16 to build from source; pre-built binaries available for macOS ARM64 (codesigned), macOS x86_64, Linux ARM64, Linux x86_64.
- No authentication on HTTP API; isolate `codedb serve` behind reverse proxy or network ACLs in shared environments.
- File watching uses polling with filtered directory walking; may lag on high-change environments; consider manual index refreshes or increased poll intervals.
- Sensitive files (`.env`, credentials, keys) are blocked at indexing time; verify `.codedbrc` for custom path exclusions in your team setup.
When to avoid it — and what to weigh
- Production code editing at scale — codedb's editor fallback (`codedb_edit`) is intentionally minimal; use it only for trivial line-range changes. Complex refactoring should use native IDE tools.
- Strict single-language ecosystems — Parser support varies: full structural parsing for Zig/C++/Python/TypeScript/Rust/Go, but lightweight regex-based outlines for Java/Kotlin/Svelte and no support for COBOL/Objective-C/Swift.
- Remote-first or multi-tenant deployments — HTTP server binds to localhost only; no authentication layer. Not suitable for shared team servers or cloud sandboxes without reverse-proxy hardening.
- Stable API guarantees — Project is marked alpha; snapshot format and internal API may change between releases. Requires pinning versions in production workflows.
License & commercial use
BSD 3-Clause License. Permissive OSI-approved license allowing commercial use, modification, and distribution with attribution and liability disclaimers.
BSD 3-Clause is a permissive open-source license clearly allowing commercial use without royalties or licensing restrictions. No proprietary license alternatives listed. Internal use and hosted deployment permitted under standard BSD terms.
DEV.co evaluation signals
Editorial assessment — not user reviews. Directional, with an explicit confidence level.
| Signal | Assessment |
|---|---|
| Maintenance | Active |
| Documentation | Strong |
| License clarity | Clear |
| Deployment complexity | Low |
| DEV.co fit | Strong |
| Assessment confidence | High |
HTTP server binds to localhost only; no authentication layer present. Sensitive files (.env, credentials) are blocked during indexing. macOS ARM64 binary is codesigned and notarized; x86_64 slice temporarily unsigned. SHA256 checksum verification in installer. No known CVEs listed. For multi-user or remote-access scenarios, deploy behind authenticated reverse proxy and validate all file exclusion rules.
Alternatives to consider
GitHub Copilot / OpenAI Code Interpreter
Hosted code intelligence; no local deployment or control; different architectural approach (cloud-based vs. local indexing). Copilot integrates directly into IDEs; codedb is agent-first and MCP-native.
Sourcegraph / CodeSearch (self-hosted)
Enterprise-grade code search with fine-grained auth; much heavier deployment footprint; more language/platform integrations. codedb is lightweight, Zig-native, MCP-focused for AI agents.
ripgrep + tree-sitter bindings
Lower-level building blocks; requires manual composition for symbol lookup and dependency graphs. codedb pre-bundles these capabilities into MCP tools; 538x faster on pre-indexed queries.
Build on codedb with DEV.co software developers
Install codedb in seconds and unlock 21 MCP tools for symbol lookup, dependency analysis, and fast trigram search across polyglot codebases. Free, BSD 3-Clause license, auto-registers in Claude, Cursor, and Gemini.
Talk to DEV.coRelated open-source tools
Surfaced by semantic similarity across the DEV.co open-source index.
Related on DEV.co
Explore the category and the services that help you build with it.
codedb FAQ
Does codedb edit code files?
Which languages does codedb fully support?
Can I run codedb on a shared team server?
What is the alpha status guarantee?
Custom software development services
From first prototype to production, DEV.co delivers software development services around tools like codedb. Our software development agency staffs experienced software developers and web developers for custom software development, web development, integrations, and ongoing support across mcp servers and beyond.
Add Code Intelligence to Your AI Workflows
Install codedb in seconds and unlock 21 MCP tools for symbol lookup, dependency analysis, and fast trigram search across polyglot codebases. Free, BSD 3-Clause license, auto-registers in Claude, Cursor, and Gemini.