CodeGraph – lokální znalostní graf kódu pro AI agenty

Vytvořeno: 30.7.2026 | Aktualizováno: 30.07.2026 13:26

CodeGraph je lokální CLI nástroj, který vytváří sémantický graf zdrojového kódu. Graf lze dotazovat přímo z příkazové řádky a CodeGraph jej umí také zpřístupnit AI coding agentům přes MCP.

Praktické představení je ve videu How To Save 90% of Claude Code Token Usage.

CodeGraph analyzuje zdrojové soubory, vytváří graf symbolů a jejich vztahů a ukládá jej lokálně do adresáře .codegraph/. Index vytváří program s vlastním Rust kernelem; nepoužívá k tomu LLM ani AI tokeny.

Nad hotovým grafem lze z CLI vyhledávat relevantní kód, cesty volání a dopad změn. Například codegraph explore vrátí vybraný kontext pro konkrétní úkol místo opakovaného hledání přes grep a čtení celých souborů.

Největší náklad AI agenta při práci ve větším repozitáři často není vlastní změna kódu, ale zjišťování souvislostí: hledání názvů, otevírání souborů, rekonstrukce cest volání a dohledávání závislostí. Každý takový krok přidává tool call a jeho výstup do kontextu.

CodeGraph tento průzkum zkracuje na několik cílených dotazů. Úspora vzniká z menšího množství přečteného kódu a méně volání nástrojů, ne z levnějšího vytváření indexu.

Projekt uvádí vlastní benchmark na sedmi open-source repozitářích: v průměru o 69 % méně tokenů, o 89 % méně tool callů a o 60 % nižší náklady. Nejde o nezávislé měření a přínos není stejný všude: pro rozsáhlý nebo provázaný repozitář je výraznější než pro malý projekt.

Úspora také závisí na tom, zda agent používá CodeGraph přímo. Pokud místo toho dál prochází soubory přes Read a grep, graf mu nepomůže tolik.

Instalační skript stáhne binární CLI pro daný systém. Před spuštěním je vhodné zkontrolovat jeho obsah a důvěryhodnost zdroje.

curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh

Poté je potřeba otevřít nový terminál, aby byl příkaz codegraph dostupný v PATH. Pro každý repozitář se graf vytvoří samostatně:

cd muj-projekt
codegraph init

Příklad dotazu nad grafem:

codegraph explore "Jak probíhá autentizace uživatele?"

Další CLI příkazy umožňují například analyzovat volající a volané symboly, dopad změny nebo určit testy ovlivněné změněnými soubory.

CodeGraph není pouze CLI. Příkaz codegraph install připojí jeho MCP server do podporovaných AI klientů, mezi které patří Claude Code, Codex CLI, OpenCode, Cursor a Gemini CLI.

codegraph install

MCP server zpřístupní agentovi stejný lokální graf jako strukturované nástroje. Základní nástroj codegraph_explore vrací obdobný kontext jako CLI příkaz codegraph explore. Agent s dokumentací a přístupem k shellu tedy může pro běžné grafové dotazy používat přímo CLI.

MCP přidává především pohodlnou integraci: agent dostane nástroj s definovanými parametry, nemusí sestavovat shellový příkaz a server může upozornit na změněné soubory, které ještě nejsou promítnuté do indexu.

Po inicializaci CodeGraph sleduje změny souborů a graf průběžně synchronizuje. Platí to i pro změny vytvořené AI agentem nebo po git pull. Synchronizace je lokální operace nad změněnými soubory; nezpůsobuje spotřebu tokenů ani volání modelu.

Ve výchozím nastavení se změny krátce seskupí a pak se index aktualizuje. Stav lze ověřit příkazem:

codegraph status

V prostředí bez běžícího watcheru, například při nastavení CODEGRAPH_NO_DAEMON=1, je možné index synchronizovat ručně:

codegraph sync

Vytvoření a aktualizace indexu vyžadují lokální CPU, paměť a diskový prostor; u velkého repozitáře tedy nejsou zdarma z pohledu výkonu, ale nejde o náklad na LLM. Projekt uvádí, že kód a index zůstávají lokálně a nevyžaduje API klíč. Anonymní telemetrii lze vypnout: