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

//Vytvořeno: **30.7.2026** | Aktualizováno: **~~LASTMOD~~**//

[[https://github.com/colbymchenry/codegraph|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.

===== Video =====

Praktické představení je ve videu [[https://www.youtube.com/watch?v=UslVzxAkiZ0|How To Save 90% of Claude Code Token Usage]].

{{youtube>UslVzxAkiZ0?}}

===== Jak CodeGraph funguje =====

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ů.

===== Úspora tokenů =====

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.

===== Instalace a použití CLI =====

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.

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

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ě:

<code bash>
cd muj-projekt
codegraph init
</code>

Příklad dotazu nad grafem:

<code bash>
codegraph explore "Jak probíhá autentizace uživatele?"
</code>

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.

===== MCP rozhraní =====

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.

<code bash>
codegraph install
</code>

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.

===== Aktualizace grafu =====

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:

<code bash>
codegraph status
</code>

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

<code bash>
codegraph sync
</code>

===== Omezení a soukromí =====

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:

<code bash>
codegraph telemetry off
</code>

===== Zdroje =====

  * [[https://github.com/colbymchenry/codegraph|CodeGraph – repozitář a dokumentace]]
  * [[https://www.youtube.com/watch?v=UslVzxAkiZ0|How To Save 90% of Claude Code Token Usage]]