Wat is een codebase-map voor coding agents?
Ontdek hoe Graft met tree-sitter en MCP een persistente index van uw repository maakt. Voorkom dat uw coding agent bij elke sessie opnieuw de volledige structuur moet scannen.
Wat een codebase-map voor coding agents is
Een codebase-map voor coding agents is een persistente index van uw repository waarin de agent informatie opzoekt, in plaats van dat deze in elke nieuwe sessie vanaf nul door de bestanden moet zoeken (greppen). Graft is een implementatie van dat concept. Het parseert uw code met tree-sitter, schrijft een map met gekoppelde markdown-nodes inclusief een wiring-graph per symbool, en stelt retrieval-tools beschikbaar via MCP (model context protocol, de standaardinterface die coding agents gebruiken om externe tools aan te roepen).
Graft is geen proxy en geen gateway. Er bevindt zich niets tussen uw agent en de model-API. De map is een directory op de schijf die de agent uitleest. Dat onderscheid bepaalt welk probleem u oplost: een self-hosted token gateway meet en routeert de verzoeken die u al verstuurt, terwijl een map het aantal verzoeken dat u überhaupt moet versturen, vermindert.
De techniek is ouder dan deze tool en zal deze overleven. Leer eerst de techniek, en daarna de werking.
Waarom coding agents context verspillen door het herontdekken van de structuur
Observeer een agent die begint te werken aan een repository die hij al vijftig keer heeft gezien. Hij somt mappen op. Hij voert grep uit voor een symbool. Hij opent drie bestanden om te achterhalen welke de functie definieert, en vervolgens een vierde om te zien wie deze aanroept. Niets daarvan is de eigenlijke taak. Het is oriëntatie, en dit wordt bij elke sessie betaald in input-tokens.
De oorzaak is eenvoudig. Een model heeft geen geheugen tussen sessies. Alles wat de agent leerde over uw structuur, bevond zich in een contextvenster dat werd verwijderd toen de sessie eindigde. Dus begint dezelfde ontdekkingstocht weer vanaf nul, en u betaalt er opnieuw voor. Prompt caching geeft alleen korting op een identiek prompt-voorvoegsel dat binnen de laatste vijf minuten is gezien, of tegen extra kosten binnen het laatste uur; het kan de verkenning van gisteren dus niet meenemen naar de sessie van vandaag. Bij een grote repository kost de oriëntatiefase meer dan de bewerking zelf: tien tool-aanroepen om de code te lokaliseren, één om deze te wijzigen. Oriëntatie is slechts de helft van de rekening en de bewerking de andere, wat de reden is waarom een vaardigheid die de agent dwingt tot de kleinst mogelijke werkende wijziging het waard is om te combineren met een kaart, in plaats van tussen beide te kiezen.
Een kaart doorbreekt die cirkel door de ontdekkingstocht te verplaatsen van het model naar de schijf. Een parser doorloopt de repository één keer, legt vast welk symbool waar is gedefinieerd en welk symbool wat aanroept, en houdt dat overzicht actueel naarmate de code verandert. De agent stelt één vraag en krijgt een antwoord inclusief bestand en regelnummer. Herhaaldelijke verkenning wordt zo een goedkope opzoekactie.
U gebruikt al een zwakkere versie hiervan. Een AGENTS.md die uw conventies beschrijft voorkomt dat de agent elke keer opnieuw uw conventies moet afleiden. Een gegenereerde kaart voorkomt dat hij uw structuur opnieuw moet afleiden. Het verschil zit in wie het schrijft. U schrijft het instructiebestand met de hand, dus het blijft klein. Een parser genereert de kaart, waardoor deze tienduizend bestanden kan beslaan. Voor waar het budget binnen een sessie daadwerkelijk naartoe gaat, behandelt hoe Claude Code zijn contextvenster besteedt de verantwoording.
Wat Graft daadwerkelijk bouwt
Twee artefacten, beide onder één graft/-map in de hoofdmap van de repository.
Het eerste is een knooppuntgraaf geschreven als gekoppelde markdown, één bestand per knooppunt. Elk knooppunt bevat een samenvatting in begrijpelijke taal, een "kern" van de belangrijke logische regels die uit de broncode zijn gehaald, de exacte bronbestanden met een content-hash, getypeerde wikilinks naar andere knooppunten (depends_on, part_of, uses, implements), en een notitiesectie die behouden blijft na regeneratie, zodat u context kunt vastleggen die een parser niet kan afleiden.
Het tweede is graft/.graph/wiring.json, de structurele graaf per symbool die tree-sitter extraheert: definities, verwijzingen en de aanroepverbindingen daartussen.
Deze splitsing is van belang omdat slechts één helft een model nodig heeft. graft build is pure tree-sitter en roept nooit een LLM (large language model) aan; het is daarom deterministisch en kost niets. graft build --deep voegt de geschreven samenvattingen en de kernen per symbool toe, en dat zijn modelaanroepen waarvoor u betaalt.
Taalondersteuning is ingedeeld in niveaus, en het niveau geeft aan in hoeverre u de aanroepgraaf kunt vertrouwen. TypeScript, JavaScript, Python, Go, Java, Kotlin, PHP, Swift en R beschikken over scope-bewuste resolutie tussen bestanden. Rust, C, C++, C#, Ruby, Scala, Elixir, Solidity, OCaml, Zig, Dart, Clojure, Nix en Lua krijgen symbolen plus generieke aanroepverbindingen, wat betekent dat een verbinding een naamovereenkomst kan zijn in plaats van een opgeloste verwijzing. Verbindingen van compiler-kwaliteit zijn optioneel beschikbaar via --lsp en een language server zoals rust-analyzer of gopls.
Graft installeren en de versie vastzetten
Graft vereist Node.js 20 of nieuwer en is uitgebracht onder de MIT-licentie. Op 17 oktober 2026 is de huidige release 0.23.0, gepubliceerd op 15 oktober 2026. De eerste versie, 0.1.0, dateert van juli 2026. Beschouw het als jonge software. Release 0.22.0, gepubliceerd op 14 oktober 2026, hernoemde het project Trail-code: dezelfde code wordt nu ook uitgebracht als @trailhq/trail-code met een trail-commando, terwijl @nanonets/graft het graft-commando behoudt.
Deze handleiding zet versie 0.21.1 vast, gepubliceerd op 29 september 2026 en de laatste release vóór de naamswijziging, omdat 0.22 en 0.23 commando's hebben gewijzigd waar deze handleiding op vertrouwt. Vanaf 0.22 vergelijkt graft check de diff van uw branch met de team-learnings van de repository en sluit af met exitcode 1 bij een conflict; drift-detectie is verplaatst naar graft build --check en de MCP-tools heten nu trail_* (de server reageert nog steeds op de oude graft_*-namen). De changelog van 0.23.0 vermeldt ook dat in een repository die is opgezet met trail, de map verhuist naar .trail/cache/ en Claude Code geen MCP-server meer krijgt, terwijl de README nog steeds graft/ en .mcp.json beschrijft. Lees de changelog en voer --dry-run uit voordat u de versie-pin wijzigt.
npm install -g @nanonets/graft@0.21.1
npm ls -g @nanonets/graftnpm ls -g hoort @nanonets/graft@0.21.1 weer te geven. Zet die versie bewust vast. Een kale npm install -g @nanonets/graft lost de latest-tag op op het moment dat u het uitvoert. Bij een project dat meerdere minor-releases per maand uitbrengt, betekent dit dat u op dinsdag een ander hulpmiddel heeft dan uw collega op maandag heeft geïnstalleerd. Een vastgezette versie houdt de CLI-flags en het grafiekformaat voor iedereen gelijk, zodat u pas upgradet wanneer u dat besluit.
Koppel het vervolgens aan een repository die u beheert:
cd /path/to/your/repo
graft init --dry-run
graft initgraft init vraagt welke van uw programmeer-agents u wilt koppelen en bouwt daarna de grafiek op. Voer eerst --dry-run uit en lees de lijst met bestanden die het programma wil wijzigen, aangezien sommige zich buiten de repository bevinden. graft init is idempotent en overschrijft bestaande configuraties niet, dus een tweede keer uitvoeren is veilig. Om wijzigingen ongedaan te maken, verwijdert graft uninstall elk bestand en elke configuratie-ingang die Graft heeft geschreven; dit is een dry run totdat u -y doorgeeft.
Dezelfde prompt bevat een selectievakje voor telemetrie. Sinds release 0.12.0 verstuurt Graft standaard een anonieme gebruiks-ping: geaggregeerde aantallen en vaste labels, nooit uw code, bestandspaden of repositorynaam. Gebeurtenissen worden maximaal één keer per dag verzonden, met één uitzondering: de installatie-gebeurtenis, die de postinstall-hook van npm direct doorgeeft aan de achtergrond-sender. Vink het vakje uit tijdens graft init, voer graft telemetry disable uit of stel DO_NOT_TRACK=1 in om dit uit te schakelen (het schakelt zichzelf ook uit in CI). graft telemetry debug toont de batch die verzonden zou worden zonder deze daadwerkelijk te versturen.
In 0.21.1 omvat de koppeling Claude Code, Cursor, Codex, GitHub Copilot, Google Gemini, Kiro, Windsurf, Grok (xAI), AdaL, Hermes Agent en Google Antigravity. Hermes Agent is sinds release 0.13.0 een eersteklas graft init-host, en in de vastgezette versie selecteren graft init --agents hermes en graft init --agents antigravity deze twee zoals elke andere host. Grok werd toegevoegd in release 0.13.0 en wordt geselecteerd met graft init --agents grok. Claude Code krijgt de diepste integratie: een MCP-server-ingang, een statusregel die de grootte en veroudering van de grafiek toont, post-edit hooks die de grafiek opnieuw opbouwen en een skill-bestand onder .claude/. De overige krijgen een instructie- of regelbestand dat de agent vertelt dat de tools bestaan (Hermes Agent en Antigravity lezen beide de AGENTS.md-sectie), en Grok krijgt ook een MCP-blok in zijn eigen configuratie. "Ondersteund" betekent daarom dat Graft de koppeling schrijft; een agent die zijn eigen regelbestand negeert, zal dus ook de map negeren. Dat is de gebruikelijke reden waarom agents de instructies die u voor hen schrijft negeren, en dat is hier net zo goed van toepassing als elders.
Wat wordt er in uw repository geplaatst en wat blijft buiten git
Na graft init kunt u het volgende verwachten:
graft/: de markdown-nodegrafiek engraft/.graph/wiring.json. Deze zijn voor u toegevoegd aan.gitignore..mcp.json: registreert de graft MCP-server zodat Claude Code deze opstart..claude/settings.json: samengevoegd op de juiste locatie, waarbij de statusregel en de post-edit hooks worden toegevoegd.AGENTS.md,GEMINI.md,.github/copilot-instructions.md,.cursor/rules/graft.mdc,.kiro/steering/graft.md,.windsurf/rules/graft.md,.grok/skills/graft/SKILL.mden.adal/skills/graft/SKILL.md: secties met marker-fencing die worden toegevoegd aan de bestanden die overeenkomen met de door u gekozen agents..grok/config.toml: een[mcp_servers.graft]-blok op repository-niveau, alleen geschreven wanneer u Grok selecteert.~/.codex/config.toml,~/.codex/hooks.jsonen~/.codex/hooks/graft/graft-hooks.cjs: machinebreed, alleen geschreven wanneer u Codex selecteert en~/.codex/al bestaat.graft init --no-globalslaat deze over, engraft init --no-hooksslaat de hook-shim zelfstandig over.
De grafiek is een cache, vergelijkbaar met node_modules. Commit deze niet. De grafiek wordt binnen enkele seconden opnieuw gegenereerd op basis van de code, verandert bij bijna elke bewerking, en het committen ervan verandert een correctie van één regel in een diff van honderden bestanden die geen enkele reviewer zal lezen. Commit in plaats daarvan de configuratie, waaronder AGENTS.md en .mcp.json. Een teamgenoot kloont de repository, voert graft build uit en krijgt zijn eigen lokale grafiek.
Controleer of de negeerregel is toegepast voordat u uw eerste commit uitvoert:
grep -n graft .gitignore
git status --shortgrep hoort een regel te tonen die graft/ bevat, en git status --short hoort niets onder graft/ weer te geven. Als bestanden onder graft/ in die uitvoer verschijnen, betekent dit dat de negeerregel ontbreekt of elders wordt overschreven. Herstel dit voordat u commit, omdat git een bestand blijft volgen zodra het is toegevoegd, en een latere .gitignore-aanpassing zal het bestand niet uit de tracking verwijderen.
Als u de MCP-server liever handmatig registreert, of deze wilt vastzetten op dezelfde versie die u hebt geïnstalleerd, is de invoer beperkt:
{
"mcpServers": {
"graft": {
"command": "npx",
"args": ["-y", "@nanonets/graft@0.21.1", "mcp"]
}
}
}De retrieval-tools die uw agent aanroept in plaats van grep
Graft stelt zes tools beschikbaar via MCP. graft_find_code retourneert gerangschikte nodes voor een taakomschrijving, inclusief bestand en regelnummer. graft_file_api retourneert elke signature in een bestand zonder de body-inhoud. graft_trace_calls doorloopt aanroepers of aangeroepenen over meerdere niveaus. graft_find_all retourneert regex-treffers gegroepeerd per symbool. graft_repo_map biedt een eerste overzicht van een onbekende repository. graft_check_freshness rapporteert of de graaf nog overeenkomt met de code.
Elke tool heeft een CLI-tegenhanger; hiermee controleert u wat uw agent daadwerkelijk ontvangt:
graft map .
graft ask "where do we validate the refresh token"
graft skeleton src/auth/session.ts
graft callers validateRefreshToken
graft callers validateRefreshToken --direction out
graft grep "refresh_token" --jsongraft ask hoort gerangschikte nodes te printen met file:line-referenties in plaats van bestandsinhoud. Dat is het volledige mechanisme: de agent ontvangt een pointer en opent één bestand, in plaats van er tien te lezen om de juiste te vinden. graft viz opent een interactieve viewer op localhost als u de graaf zelf wilt bekijken. Als graft ask niets nuttigs retourneert voor een vraag die u in dertig seconden zelf kunt beantwoorden, formuleer deze dan niet opnieuw om het nogmaals te proberen. Gerangschikte retrieval kan missen, en het skill-bestand van het project zelf stelt dat zwakke treffers betekenen dat u moet overschakelen naar graft grep, graft skeleton of graft callers. Als die ook tekortschieten, controleer dan op drift (graft check . op de vastgezette 0.21.1, graft build --check vanaf 0.22) en bevestig in welke tier uw taal valt, omdat een verouderde graaf of edges in een brede tier uw agent op dezelfde manier zullen laten falen.
Eén kostenpost wordt gemakkelijk over het hoofd gezien. Zes tool-definities worden bij elk verzoek voor de gehele sessie in de system prompt geïnjecteerd. U betaalt die kosten, ongeacht of de agent de map gebruikt of niet. Bij een repository die klein genoeg is om in de context te passen, kan deze vaste last groter zijn dan de besparing door de exploratie.
Wat gebeurt er met de graaf wanneer de code wijzigt
Een structurele verversing is goedkoop en verloopt automatisch. Graft leest uw werkmap in plaats van git, waardoor een wijziging die u nog niet heeft gecommit en een wijziging die u heeft gestaged, beide direct zichtbaar zijn. Elke query controleert eerst de status van de werkmap en parseert alleen de bestanden die zijn gewijzigd opnieuw. De documentatie van 0.21.1 schat die controle op ongeveer 3 ms wanneer er niets is veranderd; de huidige README spreekt van enkele tientallen milliseconden, ongeveer 50 ms in de eigen repository van het project. Een herbouw aan het einde van een beurt raakt alleen bestanden aan waar code is verplaatst. Stel GRAFT_NO_REFRESH=1 in of geef --no-refresh mee om antwoord te krijgen op basis van de graaf op schijf zonder opnieuw te parsen. Geef --no-reuse mee om een volledige koude her-parsing af te dwingen; dit is wat u wilt na het upgraden van Graft zelf.
Het door het model geschreven gedeelte gedraagt zich anders, en dit is het onderdeel dat ongemerkt fout kan gaan. Samenvattingen en kernpunten worden gecachet. Elk knooppunt legt een content-hash van de bronbestanden vast, dus wanneer een bronbestand wijzigt, wordt het knooppunt gemarkeerd als verouderd in plaats van als actueel gepresenteerd. Die vlag helpt alleen als er actie op wordt ondernomen. Ververs met graft build --deep, wat opnieuw model-tokens verbruikt.
Maak veroudering zichtbaar:
graft check .
echo $?Op de vastgezette versie 0.21.1 betekent exit-status 0 dat de graaf overeenkomt met de code en exit-status 1 betekent dat er sprake is van afwijking. Vanaf 0.22 sluit graft check af met 1 bij een conflict met een team-learning, en is de drift-gate graft build --check, dus pas het commando aan wanneer u de pin verplaatst. Voer het uit vanuit een pre-push hook, zodat een zes maanden oude kaart niet met zekerheid antwoord kan geven over code die in maart is herschreven. De README van 0.21.1 beschrijft graft check als een lokaal versheidssignaal, en de huidige README vermeldt build --check voor CI. Hoe dan ook wordt graft/ genegeerd door git, dus een verse CI-checkout start zonder graaf, tenzij de job er een bouwt.
Bestudeer de gepubliceerde benchmarkcijfers zorgvuldig
De README van versie 0.21.1 opende met "tot 4x goedkoper en 3x sneller, met betere of gelijkblijvende correctheid". De huidige README heeft die regel verwijderd en opent met bescheidener cijfers: "Over 162 runs van dezelfde agent op dezelfde taken: 32% lagere kosten, 42% minder ongecachte input-tokens, 60% minder tijd en hetzelfde aandeel correcte antwoorden." Deze cijfers zijn afkomstig uit de eigen benchmarks van het project, zoals gepubliceerd in de README. Hieronder staan de twee runs die volledig worden gerapporteerd.
De gegevens achter deze grafiek
[
{
"label": "Controlled sweep",
"run_count": 162,
"token_saving_pct": 42,
"tool_call_saving_pct": 46,
"correctness_pct": 93,
"baseline_correctness_pct": 93
},
{
"label": "SWE-bench Verified",
"run_count": 50,
"token_saving_pct": 23,
"tool_call_saving_pct": 25,
"correctness_pct": 66,
"baseline_correctness_pct": 54
}
]De gecontroleerde sweep bestaat uit 162 runs over twee repositories, waarvan één Graft zelf, met drie pogingen per taak. Het rapporteert 42% minder ongecachte input-tokens en 46% minder tool-aanroepen. De SWE-bench Verified-run omvat 50 instanties met hetzelfde model voor beide groepen, en rapporteert een kleinere besparing: 23% van de tokens en 25% van de tool-aanroepen. Een derde run van 15 PocketBase-taken, tien ontwikkelaarsvragen plus vijf gereproduceerde samengevoegde pull requests, kostte in totaal 11.02 Amerikaanse dollar tegenover 13.91 voor de baseline.
Beschouw dit alles als een leveranciersbenchmark. Twee factoren beperken de waarde van deze informatie. De gecontroleerde sweep bevat de eigen repository van Graft, de codebase waarop de auteurs hun tool hebben afgestemd. SWE-bench Verified is een publieke dataset met issues uit bekende open-source Python-projecten, en publieke datasets zijn de bronnen waarop tools worden geoptimaliseerd, of dat nu bewust gebeurt of niet. Geen van beide is een uitspraak over uw eigen private monorepo, die zijn eigen naamgevingsconventies en dode code bevat.
Correctheid verdient een tweede blik. Bij de gecontroleerde sweep veranderde deze niet: 93% met de map tegenover 93% zonder. De sprong naar 66% vanaf 54% verschijnt alleen bij SWE-bench Verified. Een tool die uw tokenkosten verlaagt en de kwaliteit gelijk houdt, is nog steeds een goede investering. Combineer echter niet het correctheidsresultaat van SWE-bench met het tokenresultaat van de sweep om deze als één claim te presenteren.
Meet uw eigen tokendelta voordat u de cijfers gelooft
Het enige getal dat ertoe doet, is het getal uit uw eigen repository. Deze methode kost een middag werk.
Kies een taak die u exact kunt herhalen. Een vraag is beter dan een bewerking, omdat een bewerking de repository wijzigt en de tweede run niet langer hetzelfde experiment is. "Welke module dwingt de rate limit af op de login-route" is de juiste vorm.
Schakel telemetrie in en stuur deze naar uw eigen terminal:
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=console
claudeDe console-exporter print metriekrecords zodra ze worden verzameld. De metriek die u nodig heeft is claude_code.token.usage, die een type-attribuut draagt van input, output, cacheRead of cacheCreation. De oriëntatie is zichtbaar in input en cacheRead, omdat daar de bestandsinhoud terechtkomt. Tel deze twee bij elkaar op.
Voer de taak drie keer uit, telkens in een nieuwe sessie, met de map gekoppeld. Verwijder daarna de graft-vermelding uit .mcp.json en voer de taak nog drie keer uit. Vergelijk de medianen in plaats van individuele runs, omdat agent-runs sterk variëren en één ongelukkige run u het tegenovergestelde van de waarheid kan vertellen. Noteer ook het aantal tool-calls: tool-calls zijn het mechanisme en tokens zijn het effect; een besparing op tokens zonder afname in tool-calls betekent dus dat er iets anders is veranderd.
Trek vervolgens de kosten af die de benchmark niet laat zien. graft build --deep verbruikt model-tokens bij elke volledige verversing. De zes tool-schema's reizen mee in elk verzoek. Als uw agents op een gehuurde server draaien, verandert het instellen van een hard plafond op agent-uitgaven dit van een verrassing in een budget, en wat de telemetrie van een coding agent daadwerkelijk rapporteert behandelt wat de machine verlaat zodra u de exporter inschakelt.
Wanneer is een codebase-map niet langer nuttig?
- De repository past al in de context. Een enkele kleine service heeft geen map nodig, en u betaalt nog steeds voor zes tool-schema's bij elk verzoek. Als uw agent vandaag elk bestand in één of twee tool-aanroepen vindt, sla het dan over.
- Uw taal bevindt zich in de brede categorie. Generieke aanroep-edges betekenen dat
graft callerseen aanroeper kan missen, of er een kan produceren door een naamconflict. Bevestig dit metgraft grepvoordat u vertrouwt op een blast radius. - De graaf is verouderd en niemand heeft het gemerkt. Op 0.21.1 sluit
graft checkaf met 1 bij drift (vanaf 0.22 doetgraft build --checkdit), wat alleen nuttig is als er iets is dat het uitvoert. Een pre-push hook, geen gewoonte. - De monorepo heeft scoping nodig. Een monorepo met één git-repository is niet opgesplitst, maar
graft builddetecteert subprojecten op basis vanpnpm-workspace.yaml,package.jsonworkspaces of per-pakketgo.mod,pyproject.tomlofCargo.tomlen gebruikt deze als ranking-scopes, engraft ask "..." --in services/billing/beperkt een query tot één subproject. Hetzelfde instinct dat leidt tot geneste AGENTS.md-bestanden per pakket is van toepassing op de map. - De agent negeert de bedrading. Observeer de tool-aanroepen in een echte sessie voordat u concludeert dat de map wordt gebruikt. Een agent die nog steeds
grepuitvoert, geeft aan dat het regelsbestand nooit is gelezen.
FAQ
Moet ik de map graft/ toevoegen aan git?
Nee. graft build voegt automatisch graft/ toe aan uw .gitignore, omdat de graaf een herberekenbare cache is, vergelijkbaar met node_modules. Deze verandert bij vrijwel elke bewerking; het toevoegen aan git zou echte wijzigingen (diffs) begraven onder honderden gegenereerde bestanden. Voeg de configuratie toe die agents vertelt dat de kaart bestaat, waaronder AGENTS.md en .mcp.json, en laat elk teamlid graft build lokaal uitvoeren. Controleer dit met grep -n graft .gitignore en git status --short vóór uw eerste commit, omdat git een bestand blijft volgen zodra het is toegevoegd; het later bewerken van .gitignore verwijdert het bestand niet uit de tracking.
Kost het draaien van Graft geld?
De structurele helft niet. graft build, graft ask, graft check en de zes MCP-retrieval-tools zijn tree-sitter-operaties die nooit een model aanroepen. graft build --deep is de betaalde helft: deze schrijft de samenvattingen in begrijpelijke taal en de kernpunten per symbool via een LLM, geconfigureerd met GRAFT_PROVIDER, GRAFT_API_KEY en GRAFT_MODEL, plus GRAFT_BASE_URL voor elk OpenAI-compatibel eindpunt. U kunt Graft alleen met de structuur draaien zonder ooit een token aan de graaf zelf te besteden.
Hoeveel bespaart een codebase-kaart daadwerkelijk op mijn repository?
Niemand kan u dat vertellen zonder metingen. Het project rapporteert 42% minder niet-gecachte input-tokens bij een eigen 162-run sweep en 23% minder tokens op SWE-bench Verified, beide afgezet tegen een baseline zonder kaart. Beide zijn leveranciersbenchmarks, waarvan er één deels op de eigen repository van Graft is uitgevoerd, en geen van beide beschrijft uw private code. Voer één herhaalbare vraag drie keer uit met de kaart en drie keer zonder, met CLAUDE_CODE_ENABLE_TELEMETRY=1 en OTEL_METRICS_EXPORTER=console ingesteld, en vergelijk vervolgens de mediaan van claude_code.token.usage voor de input en cacheRead types.
Wat gebeurt er met de graaf wanneer ik refactor?
De structuur parseert zichzelf opnieuw. Graft controleert de werkmap en parseert alleen de bestanden die zijn gewijzigd, waardoor een hernoeming bij de volgende query wordt opgepikt. Wanneer er niets is verplaatst, kost die controle ongeveer 3 ms in 0.21.1 en enkele tientallen milliseconden in de huidige release. Het ziet niet-gecommitteerd werk omdat het bestanden leest in plaats van de git-historie. De door het model geschreven samenvattingen verouderen wel: elk knooppunt slaat een content-hash van zijn bronnen op, en een gewijzigde bron markeert het knooppunt als verouderd in plaats van het te herschrijven. Controleer op drift (graft check . in 0.21.1, graft build --check vanaf 0.22), en voer vervolgens graft build --deep uit om de geschreven helft te verversen.
Welke programmeer-agents kunnen Graft vandaag gebruiken?
Op de vastgezette versie 0.21.1 koppelt graft init Claude Code, Cursor, Codex, GitHub Copilot, Google Gemini, Kiro, Windsurf, Grok (xAI), AdaL, Hermes Agent en Google Antigravity; in totaal elf hosts. De changelog vermeldt Hermes Agent als een eersteklas host sinds 0.13.0, en hermes en antigravity zijn standaard --agents-ids op de vastgezette release. Claude Code krijgt de meeste ondersteuning: een MCP-server-entry in .mcp.json, een statusregel, post-edit hooks en een skill-bestand onder .claude/. Codex krijgt een AGENTS.md-sectie plus machine-brede entries onder ~/.codex/, die graft init --no-global overslaat. Grok krijgt een skill-bestand plus een MCP-blok in .grok/config.toml. Hermes Agent en Antigravity lezen de AGENTS.md-sectie, en de anderen ontvangen een rules- of steering-bestand. Elke andere MCP-client kan de server direct gebruiken door het commando npx -y @nanonets/graft@0.21.1 mcp te registreren.