Summary

codedb is a high-performance code intelligence server and toolset for AI agents. It provides fast, structured access to codebase information, enabling AI models to understand, navigate, and modify code efficiently, significantly reducing token consumption and improving developer workflows.

How It Works

Built in pure Zig with zero dependencies, codedb employs multi-indexed structures: outlines, trigram search, O(1) word index, and dependency graph. These in-memory indexes yield sub-millisecond query responses, outperforming file scanning or AST re-parsing. Communication uses the Model Context Protocol (MCP) over stdio or HTTP.

Quick Start & Requirements

Installation is via curl -fsSL https://codedb.codegraff.com/install.sh | sh, automatically registering codedb with AI agents. Building from source requires Zig 0.15+. The server binds to localhost by default, needing no authentication. Binaries are available for macOS and Linux.

Highlighted Details

• Offers 16 MCP tools for code intelligence: file tree, symbol lookup, search, atomic edits, dependency graph, and more.
• Features trigram-accelerated search and O(1) word index, achieving query speeds up to 1,554x faster than CLI tools.
• codedb_remote queries public GitHub repos via codedb.codegraff.com without local cloning.
• Demonstrates significant token efficiency for AI agents, reducing query output by up to 1,628x.

Maintenance & Community

The project is actively developed, with macOS binaries codesigned and notarized. Designated "Alpha software," it may have API instability and format changes, though it's used in production AI workflows. No specific community channels or external sponsorships are detailed.

Licensing & Compatibility

The project's license is detailed in a LICENSE file. No specific restrictions for commercial use are mentioned. The HTTP server defaults to binding on localhost, enhancing local development security.

Limitations & Caveats

As alpha software, the API is subject to change, and snapshot formats may be updated. Current language support is limited to Zig, Python, and TypeScript/JavaScript, with more planned. The HTTP server lacks authentication.