CodeGraph: граф знань будь-якої теки для вашого ШІ-агента

Почніть нову сесію з ШІ-асистентом для коду на кшталт Claude Code чи Cursor, і щоразу побачите ту саму картину. Запитайте про якусь функцію, і агент піде по колу: ls, grep, read_file, і знову. Він називає це дослідженням, а ви платите за кожен токен, який він спалює, поки шукає, де у вас лежить логіка автентифікації.

Ця фаза пошуку — прихований податок на розробку з агентами. Модель із міркуваннями експертного рівня поводиться як бібліотекар, що гортає кожну книжку в будівлі, аби знайти каталог. CodeGraph змінює цю арифметику. Він віддає заздалегідь побудовану структурну карту кодової бази через сервер Model Context Protocol (MCP), і агент може пропустити пошук і одразу перейти до відповіді. У середньому це скорочує виклики інструментів більш ніж на 70%, а витрати на токени майже вдвічі.

Що всередині

CodeGraph створений для швидкого аналізу коду, і працює він завдяки трьом компонентам.

Парсинг через Tree-sitter

У центрі — конвеєр розбору на Tree-sitter. Інструменти пошуку на регулярних виразах зіставляють текстові шаблони, а CodeGraph запускає справжній парсер на основі граматики. Тому він набагато точніше розуміє будівельні блоки коду: функції, класи та зв'язки між ними.

Міст через MCP

CodeGraph спілкується з агентом через MCP, який стандартизує обмін між агентом і графом на основі JSON-RPC.

Графова схема в SQLite

Усе видобуте, тобто символи та зв'язки між ними, потрапляє в оптимізовану графову схему SQLite, розраховану на швидкі запити, і все це лишається на вашій машині.

Дві переваги, крім швидкості

Щільніший контекст, менше токенів

Агентів часто накриває роздутий контекст: моделі згодовують великі заплутані файли лише для того, щоб вона знайшла одну функцію. CodeGraph натомість дає щільний контекст. Він витягує тільки потрібні символи та їхні зв'язки, і модель отримує максимум інформації за мінімум токенів.

Код лишається у вас

Коли стільки ШІ працює в хмарі, про приватність варто подумати. CodeGraph працює всередині локального периметра. Вихідний код і побудований з нього граф SQLite ніколи не залишають ваш комп'ютер, а агент звертається до локального сервера. Ваша інтелектуальна власність не потрапляє ні до зовнішньої індексації, ні до навчання.

Як це працює

Ефективність забезпечує внутрішній конвеєр із чотирьох етапів, який перетворює сирі вихідні файли на швидкий граф знань. Коротко: парсер читає код, символи та зв'язки потрапляють у локальне сховище SQLite, а сервер MCP відповідає з нього на запити агента.

Встановлення

Перетворити теку на граф знань можна швидко, локально й за кілька кроків.

Встановлення пакета

CodeGraph — легка утиліта командного рядка. Встановіть її глобально через npm:

npm install -g @colbymchenry/codegraph

Індексація проєкту

Запустіть команду init з теки проєкту. CodeGraph просканує файли, розбере їхню структуру через Tree-sitter і побудує локальний граф у SQLite.

codegraph init -i

Підключення агента

Коли індексація завершиться, підключіть свого асистента, чи то Claude Code, Cursor або інший, через міст MCP. Відтоді агент звертається до графа напряму й обходиться без дорогого дослідження.

codegraph install

Розробник, агент і граф працюють разом

Справжня віддача з'являється у зв'язці з трьох учасників. Ви задаєте намір, агент міркує, а CodeGraph дає структурну карту. Оскільки цикл замкнений, кожне рішення спирається на те, що справді є в кодовій базі.

Місце серед схожих інструментів

CodeGraph сильний у структурному картуванні, але це лише один інструмент із цілого набору, який робить агентів для коду розумнішими. Graphify видобуває з кодової бази зміст, а lat.md допомагає керувати намірами. CodeGraph дає під ними базовий структурний шар, тож усі три доповнюють одне одного.

Увесь процес

Увесь процес локальний, приватний і вбудований в асистентів, якими ви вже користуєтеся. Описуючи символи й те, як вони пов'язані, CodeGraph дає агентові справжнє розуміння архітектури. Окремий набір команд MCP дає йому змогу орієнтуватися в складних кодових базах і аналізувати радіус ураження, тобто заздалегідь бачити, які частини залежать від шматка коду, поки зміна не перетворилася на проблему.

Підсумок

Агенти, які витрачають час і гроші на дослідження кодової бази, швидко стають дорогими. CodeGraph дає їм точну заздалегідь проіндексовану карту, і вони перестають вдавати бібліотекарів і починають розв'язувати задачі. Вважайте його одним шаром агентного стеку: структура від CodeGraph, зміст від Graphify, наміри від lat.md. Принцип простий: найдорожче, що може робити агент, — це роздивлятися довкола, а з картою йому досить просто подивитися.