justrach/codedb

해결하는 문제

codedb는 AI 코딩 에이전트가 대규모 코드베이스를 탐색하고 이해하도록 돕기 위해 설계된 컨텍스트 엔진입니다. 리포지토리의 구조적 맵을 에이전트에게 제공함으로써 '환각' 현상이나 컨텍스트 부족 문제를 해결하며, 리포지토리의 모든 파일을 읽지 않고도 정의, 호출자, 의존성을 찾을 수 있게 합니다.

작동 방식

Zig으로 구축된 codedb는 로컬 파일 시스템을 인덱싱하고 Model Context Protocol (MCP)을 통해 일련의 도구를 제공합니다. 트라이그램 가속 전체 텍스트 검색, O(1) 단어 조회를 위한 역색인, 그리고 선택적 의미론적 검색(호스팅된 임베딩 또는 로컬 ANN 검색 사용)을 결합한 하이브리드 검색 시스템을 사용합니다. 심볼, 호출 경로, 의존성 그래프를 포함하는 코드베이스의 구조적 맵을 생성하며, 이는 MCP 서버, HTTP 서버 또는 CLI를 통해 에이전트에게 제공될 수 있습니다.

대상 사용자

AI 코딩 에이전트(Claude Code, Cursor, Windsurf, Devin, Copilot CLI 등)를 사용하는 개발자 중, 프로젝트의 구조적 관계와 소스 컨텍스트를 더 깊고 정확하게 이해해야 하는 분들에게 적합합니다.

주요 특징

• MCP 통합: 다양한 MCP 클라이언트를 기본 지원하여 에이전트가 codedb_explain 및 codedb_callpath와 같은 도구를 사용할 수 있습니다.
• 고성능: ripgrep이나 grep과 같은 기존 도구에 비해 심볼 및 전체 텍스트 검색 시 지연 시간이 매우 짧습니다.
• 토큰 효율성: 원시 라인 덤프 대신 구조화된 관련 결과만 반환하므로 AI 에이전트의 토큰 사용량을 크게 줄여줍니다.
• 광범위한 언어 지원: Zig, C/C++, Python, TypeScript/JavaScript, Rust, Go, PHP, Ruby, HCL, R, Dart/Flutter 및 OCaml에 대한 파서를 지원합니다.
• 멀티 플랫폼: macOS, Linux, Windows용 네이티브 바이너리를 제공합니다.