Багодельня
Инструменты и плагины

CodeGraph — индекс кодовой базы

CodeGraph — CLI + MCP-сервер, который заранее строит граф-индекс кода. Агент не шарит по файлам через grep/read, а спрашивает индекс — меньше токенов и вызовов.

CodeGraph — CLI-утилита и MCP-сервер, которые заранее строят граф-индекс твоей кодовой базы. Девиз: «fewer tokens, fewer tool calls, 100% local».

Какую проблему решает

Когда агент разбирается в проекте, он обычно рыщет по файлам: grep, glob, read, плодит сабагентов на разведку. Это жрёт токены и вызовы инструментов — и повторяется каждый раз заново.

CodeGraph убирает эту рутину: вместо живого поиска агент обращается к готовому семантическому индексу — кто кого вызывает, где определён символ, как связаны куски кода.

Как работает

  1. Парсит код через tree-sitter (20+ языков).
  2. Складывает в локальную SQLite граф: символы, связи, граф вызовов, структуру.
  3. Авто-синк — следит за изменениями файлов и доиндексирует инкрементально.
  4. Отдаёт агенту MCP-инструменты: codegraph_explore, codegraph_search, codegraph_node, codegraph_callers.

Всё локально — индекс лежит в .codegraph/ в проекте, наружу ничего не уходит.

Установка

npx @colbymchenry/codegraph   # настроит твоих агентов
codegraph init                # в каждом проекте — построить индекс

Ставится как MCP в Claude Code, Cursor, Codex, Gemini и др. Когда в проекте есть .codegraph/, агент сам начинает пользоваться его инструментами.

Выгода и когда брать

По бенчмаркам авторов — около −16% стоимости, −58% вызовов инструментов и −22% времени на реальных репозиториях.

  • Хорош когда: большая кодовая база, агент много времени тратит на «понять, где что лежит».
  • Меньше пользы: крошечный проект, где обойти файлы и так дёшево.

Идея в одном ряду с экономией токенов: меньше слепого поиска по коду — меньше входных токенов и вызовов. Только CodeGraph бьёт по самому дорогому — по разведке кодовой базы.

Проверь себя

  1. 1. Что делает CodeGraph?

  2. 2. За счёт чего CodeGraph экономит токены и вызовы?

  3. 3. Куда CodeGraph отправляет твой код?

On this page