# codedb

> Zig code intelligence server and MCP toolset for AI agents. Fast tree, outline, symbol, search, read, edit, deps, snapshot, and remote GitHub repo queries.

- **URL**: https://www.freshcrate.ai/projects/codedb
- **Author**: justrach
- **Category**: MCP Servers
- **Latest version**: `v0.2.5824` (2026-06-04)
- **License**: BSD-3-Clause
- **Source**: https://github.com/justrach/codedb
- **Homepage**: https://codegraff.com/blog/codedb-code-intelligence
- **Language**: Zig
- **GitHub**: 742 stars, 49 forks
- **Registry**: github
- **Tags**: `agentic-ai`, `agents`, `anthropic`, `cursor`, `gemini`, `mcp`, `openai`, `zig`

## Description

Zig code intelligence server and MCP toolset for AI agents. Fast tree, outline, symbol, search, read, edit, deps, snapshot, and remote GitHub repo queries.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v0.2.5824` | 2026-06-04 | High | A deterministic **code-graph** layer, a ~3× faster cold path, and a warm CLI — plus a batch of correctness fixes from a great community audit.  ## ⚡ Performance - **Snapshot load ~3×** — 380 → 125 ms on ~39k files; peak RSS **795 → 457 MB** (−338 MB). mmap'd content section, borrowed strings, zero-copy `ContentCache`, parallel freshness check, no re-hashing on load. (#524) - **Cold index: RSS 4.3 GB → 1 GB, wall-time ~6.5×** — worker-local parallel scan. (#519) - **Parallel WordIndex build** — c |
| `v0.2.5823` | 2026-05-29 | High | `0.2.5823` is an MCP compatibility hotfix for direct `tools/call` requests. It ships the issue #512 fix and adds a wire-level stdio backtest so future releases catch this exact client-wrapper failure mode.  ### MCP direct tool-call compatibility  - **#512 — direct calls no longer drop inline args when `arguments` is empty.**   Some clients send canonical MCP `params.name` and `params.arguments`, but a   wrapper layer may also emit `arguments: {}` while placing the real fields   inline on `params |
| `v0.2.5820` | 2026-05-26 | High | ## v0.2.5820  Version bump — identical to v0.2.5819 except the version string is `0.2.5820` so `codedb update` correctly sees it as newer than `0.2.58181`.  See [v0.2.5819 release notes](https://github.com/justrach/codedb/releases/tag/v0.2.5819) for the full changelog (telemetry fix, installer hooks, Linux cross-compile fix). |
| `v0.2.5817` | 2026-05-21 | High | ## TL;DR  v0.2.5817 ships **reader.md** — a hash-stable, agent-authored codebase map that codedb auto-prepends to `codedb_context` responses. Plus the perf + security bundle from v0.2.5816 (which never got tagged), plus three new `codedb_context` enhancements (inline symbol bodies, callers section, task-length gate).  **Highlights vs the released v0.2.5815:**  \| \| v0.2.5815 \| v0.2.5817 \| \|---\|---\|---\| \| `Suspense` regex p50 \| 2.82 ms \| **0.18 ms** (15.6× faster) \| \| `useState` regex p99 \| 16.57 |
| `v0.2.5812` | 2026-05-07 | High | Two papercuts surfaced verifying v0.2.5811.  ## Explore (#445)  - **`codedb_deps depends_on` no longer dupes multi-aliased imports.** A file aliasing the same dep across multiple `@import` sites previously appeared once per `@import` in the forward edges — `src/main.zig` in this very repo showed `index.zig` 5x and `mcp.zig` 2x. `rebuildDepsFor` now dedupes via a `StringHashMap(void)` before calling `setDeps`. The reverse index (`getImportedBy`) was already correct.  ## MCP  - **`codedb_find` des |
| `v0.2.5807` | 2026-05-06 | High | ## What's new  Single bundled release covering six issues across `searchContent`, `searchInContent`, and `codedb_callers`. Headline: a multi-signal reranker for `searchContent` plus a P0 crash fix in `searchInContent`.  Closes #425, #426, #427, #429, #430, #431.  ### Reliability  - **`searchInContent`: bounds-check fixes a P0 crash (#431).** When the query was longer than any indexed file's content, `content.len - query.len + 1` underflowed `usize` and the binary aborted with integer-overflow pa |
| `v0.2.579` | 2026-04-30 | High | ## v0.2.579 — MCP root resolution, wiki.codes remote, language coverage  Big thanks to @dantetemplar, @demfabris, @destroyer22719, and @GrowtricsAI for filing issues and testing — this release closes a pile of them.  ---  ### Works with Cursor, Windsurf, Devin, Kilo Code, Claude Code, and Codex  Install once, works everywhere:  ```sh curl -fsSL https://codedb.codegraff.com/install.sh \| sh ```  The installer auto-registers codedb as an MCP server in Claude Code, Codex, Cursor, and Gemini CLI. For |
| `v0.2.572` | 2026-04-14 | High | # codedb v0.2.572 🚀  **Performance. Memory. Correctness.**  This release ships 18 performance and correctness improvements, 11 bug fixes, and massive memory reductions for large repos. Initial indexing is now **10× faster**, cold RSS is down **83%**, and warm reopen is **92% leaner**.  ---  ## 🎯 Highlights  ### 10× Faster Initial Indexing Worker-local parallel scan with deterministic merge: each thread builds its own partial `Explorer`, then results are merged with no lock contention. Shuts do |
| `v0.2.57` | 2026-04-13 | High | # codedb v0.2.57 🚀  **Performance. Memory. Correctness.**  This release ships 18 performance and correctness improvements, 11 bug fixes, and massive memory reductions for large repos. Initial indexing is now **10× faster**, cold RSS is down **83%**, and warm reopen is **92% leaner**.  ---  ## 🎯 Highlights  ### 10× Faster Initial Indexing Worker-local parallel scan with deterministic merge: each thread builds its own partial `Explorer`, then results are merged with no lock contention. Shuts dow |
| `v0.2.56` | 2026-04-09 | High | ## Hotfix  - `install.sh` now resolves the latest version from GitHub Releases first and only falls back to `codedb.codegraff.com/latest.json` if GitHub is unavailable. - `codedb update` now uses the same GitHub-first lookup, which avoids stale latest-version metadata during post-release propagation windows. - The install worker reduces `/latest.json` cache time from 5 minutes to 1 minute and bumps its fallback version to `0.2.56`.  ## Validation  - `codedb-darwin-arm64` was signed on this Mac a |

## Dependency audit

- **Score**: 100/100
- **Total deps**: 0
- **Resolved**: 0
- **Unresolved**: 0
- **License conflicts**: 0
- **Warnings**: 0
- **Scanned**: 2026-06-01

## Citation

- HTML: https://www.freshcrate.ai/projects/codedb
- Markdown: https://www.freshcrate.ai/projects/codedb.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/codedb/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._