v0.2.56

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 and notarized successfully.
  Submission ID: bb1bd05b-641d-4b05-8133-fa7d5dd5e614
• codedb-linux-x86_64 passed sandbox smoke testing against sandbox-docs.md.
  Verified: --version, tree, search sandbox, and word memory

Included Assets

• codedb-darwin-arm64
• codedb-linux-x86_64
• checksums.sha256

Held Back

• codedb-darwin-x86_64 pending #223
• codedb-linux-aarch64 built locally but not runtime-validated yet

The 0.2.55 release notes still apply for the warm-reopen, MCP startup, and performance improvements.

v0.2.55

What's New

0.2.55 is a performance and reliability release focused on warm reopen, MCP startup behavior, search quality, parser correctness, and release/install safety.

Highlights

• Warm snapshot reopen now restores persisted outline/state directly, reuses trigram sidecars, and skips redundant word.index rewrites. This closes #220.
• codedb_query adds a composable MCP search pipeline for multi-step retrieval in one tool call. This closes #168.
• Search ranking now learns from query-to-open history with WAL-backed combo boosts. This closes #195.
• MCP sessions now record real client identity and expose memory diagnostics in codedb_status. This closes #37.
• Root policy now refuses to index the home directory itself, preventing the large MCP RAM spike reported in #174.
• Installer and update flows now download binaries directly from GitHub Releases instead of the old CDN path.
• Parser and correctness fixes landed for block comments, Python docstrings, ANSI stripping, and large-repo mmap cache validation.

Performance

All numbers below were measured locally on the same machine with ReleaseFast, comparing 0.2.55 against v0.2.54.

Large-repo CLI (openclaw)

Benchmark	0.2.55	0.2.54	Delta
cold tree	5.32s	5.29s	+0.6%
snapshot	6.53s	6.25s	+4.6%
warm tree	0.26s	6.16s	23.7x faster
warm search workspace	0.24s	6.14s	25.6x faster
warm word session	0.61s	5.99s	9.9x faster

MCP first secondary-project call (openclaw)

Tool	0.2.55	0.2.54	Delta
codedb_tree	0.076s	5.289s	69.6x faster
codedb_search	0.067s	5.278s	78.8x faster
codedb_word	0.285s	5.312s	18.6x faster

Peak RSS (openclaw)

Benchmark	0.2.55	0.2.54
cold tree	3478.8MB	3478.1MB
warm tree	192.6MB	3314.0MB
warm search	193.3MB	3312.9MB
warm word	677.1MB	3313.3MB

Cold paths stayed effectively flat, snapshot creation stayed within threshold, and warm CLI + MCP reopen became dramatically faster with much lower warm RSS.

Included Work

• #222 perf: speed up warm snapshot reopen
• #204 test: regression tests for #179 parser fixes
• #203 fix: parse code after single-line /* */ comments
• #202 fix: 5 bugs from issue #179
• #201 fix: install script downloads from GitHub releases
• #200 feat: combo-boost ranking from WAL
• #199 feat: cloud WAL sync — hashed profiling telemetry
• #198 feat: WAL profiling — latency + file access logging
• #194 feat: search UX — auto-retry, per-file truncation, query WAL, skip dirs
• #192 feat: MCP client identity + memory diagnostics
• #191 fix: mmap_overlay fail-safe on allocation pressure
• #190 perf: mmap overlay pattern for zero-heap incremental updates
• #189 fix: releaseContents reclaims HashMap bucket memory
• #180 feat: composable search pipeline — codedb_query
• #178 fix: block home directory indexing to prevent 17GB RAM spike
• #177 fix: correct install URL in nuke output
• #176 fix: codedb update downloads directly from GitHub releases

Credits

• Warm reopen, ranking, MCP, parser, and release-path work in this release was implemented by @justrach.
• Thanks to @nevindra for reporting #174 (MCP mode: 17GB RAM spike when Claude Code starts in home directory), fixed in #178 by @justrach.
• Thanks to @cktang88 for reporting #179 (Bugs + improvements), fixed by @justrach across #202, #203, and #204.
• #220, #195, #168, #37, and the follow-up Intel Mac holdback issue #223 were opened by @justrach.

There were other issues active around this same calendar window, but the credits above are scoped to the directly issue-linked fixes that shipped in the v0.2.54..v0.2.55 release diff.

Release Notes

• Included in this release:
  • codedb-darwin-arm64
  • codedb-linux-x86_64
• codedb-darwin-arm64 was signed on this Mac and notarized through Apple before release.
• codedb-linux-x86_64 passed sandbox smoke testing on sandbox-docs.md.
• Held back from this release:
  • codedb-darwin-x86_64 pending #223 (startup crash under Rosetta on Apple Silicon)
  • codedb-linux-aarch64 built locally but not yet runtime-validated

v0.2.54

What's New

mmap-backed trigram index (#164)

• Memory-maps trigram.postings and trigram.lookup instead of heap HashMaps
• O(log n) binary search on sorted lookup table, ~0 RSS (OS page cache)
• 121MB RSS reduction on 5k-file repos

Fuzzy file search — codedb_find (#163)

• Smith-Waterman scoring with affine gap penalties — handles transpositions, typos, missing chars
• 100% top-3 recall, 93.9% top-1 across 82 test queries
• Multi-part queries: "snapshot json" matches both parts
• Extension constraints: "auth *.py" filters by file type
• Special entry point bonus: main.zig, index.ts, lib.rs rank higher
• ~31μs average latency

codedb nuke command (#169)

• Kills all running codedb processes
• Removes ~/.codedb/ data directory and all project snapshots
• Works from any directory — no project root needed
• Usage: codedb nuke

Process lifecycle hardening

• Fix double-join undefined behavior on scan_thread
• Shutdown gates in scanBg between all phases
• Sub-second shutdown via 1s sleep granularity + POLLHUP detection
• Idle timeout increased from 2min to 10min (#148)

CI improvements

• Bench comparison now tolerates new tools (no false tool mismatch failures)
• Added --min-abs-ns threshold to prevent false positives on fast tools

Install

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

v0.2.53 — Trigram v2: 36% faster indexing, 538x faster than ripgrep

v0.2.53 — Trigram v2, /update page, README refresh

Trigram Index v2

• Integer doc IDs — u32 postings instead of string HashMaps per trigram
• Batch-accumulate — local HashMap per file, bulk-insert to global index
• Skip whitespace trigrams — 12% of occurrences are pure whitespace, terrible filters
• Sorted merge intersection — O(n+m) with zero allocations

Result: 36% faster indexing, 59% less CPU, 63% faster dense queries.

Benchmark: codedb vs rtk vs ripgrep vs grep on rtk-ai/rtk

Tool	Latency	Speedup
codedb	0.065ms	baseline
rtk	37ms	569x slower
ripgrep	45ms	692x slower
grep	80ms	1,231x slower

Also in this release

• /update page with Chart.js benchmark visualizations
• README updated with v0.2.52 features, rtk benchmark, trigram v2 numbers
• 10 trigram regression tests

Binaries

Binary	Platform	Notes
codedb-darwin-arm64	macOS Apple Silicon	Codesigned + notarized
codedb-linux-x86_64	Linux x86_64	ELF, statically linked
checksums.sha256	SHA256 verification

Install

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

Thanks to @burningportra, @unliftedq, @riccardodm97, @dezren39, @sanderdewijs, @whygee-dev, @kenrick-g for reporting issues.

Full changelog: v0.2.52...v0.2.53

v0.2.52 — Installer Fix + Correct Linux Binary

v0.2.52 — Installer Fix + Correct Linux Binary

Fixes

• Installer broken (#138) — version grep now handles whitespace in JSON, added user-agent to avoid Cloudflare blocking
• Correct Linux binary (#139) — v0.2.5 shipped macOS binary as Linux; this release has verified ELF x86_64
• Checksum verification (#120) — installer now verifies SHA256 after download
• isPathSafe hardened (#122) — blocks null bytes and backslash separators
• Memory optimizations restored — releaseContents/releaseSecondaryIndexes for large repos (lost in previous merges)

Binaries (verified)

Binary	Platform	Type
codedb-darwin-arm64	macOS Apple Silicon	Mach-O arm64, codesigned + notarized
codedb-linux-x86_64	Linux x86_64	ELF 64-bit LSB, statically linked

Install

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

Thanks to @riccardodm97 (#138, #139) for reporting the installer and binary issues.

v0.2.5 — Memory, Parser, Reliability (Linux hotfix)

v0.2.5 (hotfix)

Fixes #139 — v0.2.5 originally shipped a macOS ARM64 binary as codedb-linux-x86_64. This release contains the correct ELF x86_64 Linux binary.

All changes from v0.2.4 → v0.2.5

Memory: Release file contents after indexing for repos >1000 files (~300-500MB saved). Zero-copy ContentRef for search. (#128 @burningportra, #129 @unliftedq)

Parser: Python docstrings (#111), TS block comments (#113), import aliases (#112, #114) — @sanderdewijs

Reliability: Singleton MCP PID lock (#110 @dezren39 @riccardodm97), crash fix (duplicate thread join), Linux update /bin/bash (#132 @riccardodm97), idle timeout 2min (#131 @riccardodm97), git_head sentinel (#130 @riccardodm97)

Security: Integer cast clamping (#123)

Binaries

Binary	Platform	Verified
codedb-darwin-arm64	macOS Apple Silicon	Mach-O 64-bit arm64, codesigned + notarized
codedb-linux-x86_64	Linux x86_64	ELF 64-bit LSB executable, x86-64, statically linked
checksums.sha256	SHA256 verification

Install / Update

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

Full changelog: v0.2.4...v0.2.5

v0.2.4 — Security Hardening & Performance

What's New in v0.2.4

Security

• Sensitive file blocking — codedb_read and codedb_edit now block access to .env, credentials.json, id_rsa, .pem/.key files via MCP tools (#93, reported by @whygee-dev)
• SSRF fix in codedb_remote — repo/action params validated against whitelist, preventing path injection (#93)
• Telemetry hardening — replaced shell-interpolated curl with argv-based exec, added mutex for ring buffer race condition (#124)

Performance

• OOM fix for large repos — trigram indexing capped at 64KB per file and 15k files total, preventing memory exhaustion on 40k+ file repos (#105, reported by @unliftedq)
• 47% less memory at 40k files (447MB → 234MB), 37% faster indexing (3.38s → 2.14s)
• Search still works for all files — non-indexed files scanned via brute-force fallback

Bug Fixes

• Python codedb_deps fixed — from mypackage.utils.helpers import X now correctly resolves to mypackage/utils/helpers.py for dependency matching (#107, reported by @riccardodm97)
• Telemetry reliability — flush to disk every 3 tool calls, sync to cloud every 10 (was only on clean exit) (#121)
• PHP language support added (#87)
• Windows build fix — cross-platform file locking and stack overflow fix (#100, by @unliftedq)

Documentation

• All 16 MCP tools now documented (was 12) — added codedb_bundle, codedb_remote, codedb_projects, codedb_index (#103, #104 — reported by @dezren39)
• codedb_remote documented with usage examples
• CLI commands table added to README
• Telemetry docs updated for accuracy

Binaries

Binary	Platform	Size	Notes
codedb-darwin-arm64	macOS Apple Silicon	1.2 MB	Codesigned + Notarized (Developer ID: Rachit Pradhan, WWP9DLJ27P)
codedb-linux-x86_64	Linux x86_64	6.7 MB	Static binary
checksums.sha256	—	—	SHA256 checksums for verification

Install / Update

curl -fsSL https://codedb.codegraff.com/install.sh | sh
# or if already installed:
codedb update

Contributors

Thanks to @whygee-dev, @unliftedq, @riccardodm97, and @dezren39 for reporting issues that made this release possible.

Full changelog: v0.2.3...v0.2.4

v0.2.3

What's new

New commands

• codedb update — self-update by re-running the install script
• codedb --version / codedb -v — prints version without needing a project root
• codedb --help — early exit help

Security

• Sensitive files excluded from live indexing — .env*, credentials.json, secrets.*, .pem, .key, SSH keys, AWS configs are now excluded from both indexing AND snapshots. Previously only snapshots filtered these. (#97, closes #96)
• Telemetry docs updated to accurately describe auto-sync behavior (#97, closes #95)
• AGENTS.md added with Codex review guidelines

Build

• macOS binaries signed with Developer ID — Developer ID Application: Rachit Pradhan (WWP9DLJ27P). Binaries now pass Gatekeeper/spctl verification. No longer ad-hoc signed.

Fixes

• CLI deps command uses correct JSON field (imported_by) (#91, closes #90)
• CLI root mismatch — detects when daemon serves wrong repo and restarts (#91)
• CLI --help/--version flags added (#91)

Docs

• BSD 3-Clause LICENSE added
• Benchmark numbers updated — openclaw 75s→2.9s, vitess 50s→~2s (reflecting 12x indexing optimization)
• All codedb2 references renamed to codedb across README, website, scripts, and source

Downloads

Platform	Binary	Size	Signed
macOS ARM64 (Apple Silicon)	codedb-darwin-arm64	1.2MB	✅ Developer ID (WWP9DLJ27P)
Linux x86_64	codedb-linux-x86_64	6.5MB	N/A (static)

Both binaries are statically linked with zero runtime dependencies.

Install / Update

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

# Update existing
codedb update

Full changelog

• #97 security: exclude secrets from indexing, add license, fix telemetry docs
• #91 fix(cli): deps field, root mismatch, add --help/--version
• #88 fix: stack overflow on Linux + conditional codesign

v0.2.2

What's new

Bug fixes

• Linux stack overflow fixed — 64MB thread trampoline prevents segfault on startup (#88, closes #84)
• Conditional codesign — codesign only runs on macOS, no more build failures on Linux (#88)
• CLI deps command — uses correct JSON field (imported_by) (#91)
• CLI root mismatch — detects when daemon serves wrong repo and restarts (#91)

New features

• codedb-cli — thin bash CLI client for the codedb HTTP daemon
• --help / --version flags for codedb-cli
• systemd service — scripts/codedb.service for running as a user service
• CLI docs — docs/cli.md

Downloads

Platform	Binary	Size
macOS arm64	codedb-macos-arm64	1.2MB
Linux x86_64	codedb-linux-x86_64	6.5MB

Both binaries are statically linked with zero runtime dependencies.

Full changelog

• #88 fix: stack overflow on Linux + conditional codesign
• #91 fix(cli): deps field, root mismatch, add --help/--version
• Closes #84, #90

v0.2.1

Changes

• fix: reject filesystem root (/) as MCP project root (Cursor startup fix)
• feat: add .claude to watcher skip list
• feat: 16 MCP tools (added bundle, remote, projects, index)
• feat: BSD-3 license with derivative optimization clause
• feat: website redesign with real benchmarks from BENCHMARK.md
• feat: privacy page
• rename: codedb2 → codedb everywhere

Benchmarks (openclaw, 7,364 files, 128MB)

Tool	Latency	vs raw tools
codedb_status	0.1ms	-
codedb_word	0.2ms	325x faster
codedb_outline	0.7ms	38x faster
codedb_deps	1.3ms	469x faster, 92x fewer bytes
codedb_symbol	3.9ms	200x faster
codedb_tree	29ms	3x faster
codedb_search	49ms	6x faster

Cold start: 2.9s for 7,364 files.