Jak kontrolovat kód od AI agenta: diff-tour návod
Jak kontrolovat kód od AI agenta, než ho mergneš: diff-tour promění diff v komentovanou prohlídku od LLM. Instalace, cena, workflow a limity.
Obsah článku 8 sekcí
V kostce
- diff-tour je open-source read-only TUI, které promění git diff v komentovanou prohlídku — napíše ji tvoje vlastní Claude Code, Codex, Gemini, OpenCode nebo Copilot CLI.
- Jedna tour změny kolem 250 řádků stojí v API cenách Claude Code zhruba 1 až 1,50 dolaru a trvá 2 až 5 minut; opětovné přehrání je zdarma.
- Každé tvrzení v tour nese štítek Verified, From the code nebo Senior view, takže poznáš, co je ověřené v kódu a co je jen obecný soud.
- diff-tour je vysvětlení, ne garance — kritické kroky si vždy otevři v editoru klávesou o a ověř proti reálnému kódu před mergem.
Agent ti napíše za minutu tři sta řádků kódu — a pak na tebe svítí zelené tlačítko „Merge". Diff skroluješ, hlava říká „vypadá to dobře", a přitom pořádně nevíš, co se vlastně změnilo. Jak kontrolovat kód od AI agenta tak, abys změně opravdu rozuměl, než ji pustíš do produkce? Přesně na tenhle problém míří nový open-source nástroj diff-tour: promění diff v komentovanou prohlídku, kterou projdeš šipkami, a ukáže ti, jak by stejnou změnu četl seniorní vývojář. V tomto návodu si ukážeme, jak diff-tour nainstalovat, kolik stojí jedna prohlídka a jak z něj postavit čtvrthodinový review rituál před každým mergem.
Kontrola kódu od AI agenta: proč diff nestačí přečíst
AI kód vypadá čistě. Syntaxe sedí, názvy proměnných dávají smysl, testy prochází — a právě to je past. Typická selhání agentova kódu nejsou překlepy, ale rozhodnutí: zduplikovaná logika, která už existuje o tři soubory dál, tichá změna chování na hranici vstupu, nebo „oprava", která rozbije rollback. To z diffu samotného nepoznáš, protože diff ukazuje, co se změnilo, ne proč a s jakými důsledky.
Pomohou AI review nástroje? Zčásti. Greptile, CodeRabbit nebo BugBot — jejichž srovnání najdeš v článku o AI code review nástrojích — umí chytat bugy a bezpečnostní díry automaticky. Mají ale jiný úkol: hledají chyby, nenaučí tě změně rozumět. Podobně i tři úrovně review z návodu jak reviewovat AI kód předpokládají, že v té nejhlubší úrovni čteš kód sám — a diff-tour je přesně nástroj, který ti to čtení udělá snadnější. Nezastupuje review, ale vrací tě do role někoho, kdo změnu schvaluje vědomě.
Co je diff-tour a jak funguje
diff-tour je open-source (MIT) terminálový nástroj od japonského studia init.co.jp — repozitář na GitHubu vznikl v říjnu 2026 a k 17. říjnu 2026 měl kolem 174 hvězd a aktivní vývoj. Jeho slogan zní: projdi diff tak, jak ho čte seniorní inženýr.
Princip je jednoduchý. Spustíš příkaz tour v repozitáři a nástroj:
- Exportuje změnu — přes
git archive,git diffagit logvytáhne soubory před a po změně, diff a commit zprávy do dočasného adresáře. - Nechá tour napsat LLM, který už používáš — Claude Code, Codex CLI, Gemini CLI, OpenCode 2 nebo Copilot CLI. Model si přečte nejen diff, ale i soubory kolem něj (proto trvá psaní 2 až 5 minut) — díky tomu vysvětlí i kód, který se nezměnil.
- Ověří výstup — tour je JSON odkazující na konkrétní soubory a řádky; diff-tour zkontroluje, že všechny odkazy existují, a chyby vrací modelu k opravě (maximálně dvakrát).
- Zobrazí prohlídku — kód na obrazovce čte vždy z gitu na správném commitu, nikdy z odpovědi modelu. Ukázkový kód, který v repozitáři není (třeba naivní varianta nebo návrh opravy), je vždy označený jako Example.
Nejužitečnější detail: každé vysvětlení nese štítek, odkud je. Verified znamená podložené kódem, testy nebo commit zprávami v repozitáři. From the code je odvozené ze struktury kódu. Senior view je obecný návrhový soud, který s tvým repozitářem nikdo neověřil. Při review přesně tohle potřebuješ — poznat, kde model cituje fakta a kde jen odhaduje.
Tour přitom není monolog. Kroky obsahují otázky k zamyšlení („co se stane, když se kupón použije dvakrát na jednu objednávku?") a odpověď se ukáže až na dalším kroku — takže si odpověď můžeš tipnout dřív, než ji uvidíš. Když ti něco není jasné, stiskneš ? a zeptáš se vlastní otázkou; odpověď se stane dalším krokem prohlídky.
Jak diff-tour nainstalovat a spustit
Připrav předpoklady
Potřebuješ git a jedno podporované CLI, nainstalované a přihlášené: Claude Code, Codex CLI, Gemini CLI, OpenCode 2 nebo Copilot CLI. Pozor na stav podpory: podle README je Gemini CLI experimentální a Copilot CLI zatím nebyl otestován s reálným modelem na plné tour — s Claude Code nebo Codex jdeš jistější cestou.
Instalace
Na macOS a Linuxu stačí instalační skript:
curl -fsSL https://raw.githubusercontent.com/init-co-jp/diff-tour/main/install.sh | sh
Skript stáhne nejnovější release pro tvůj systém, ověří checksum a umístí příkaz tour do ~/.local/bin — pokud adresář nemáš v PATH, skript vypíše řádek, který máš přidat do profilu shellu. Alternativně s Go 1.27 a novějším: go install github.com/init-co-jp/diff-tour/cmd/tour@latest. Instalaci ověříš příkazem tour --version.
První tour na ukázkovém repozitáři
Než nástroj pustíš na vlastní kód, vyzkoušej ho na připraveném příkladu z ukázkového repozitáře (říjen 2026) — jde o malou službu s větví, která přidává kupóny do objednávky:
git clone https://github.com/init-co-jp/diff-tour-example
cd diff-tour-example
git checkout feature/coupons
tour
Při prvním spuštění zvolíš jazyk a LLM — obojí má doporučenou volbu, stačí dvakrát Enter. Pak vybereš změnu (aktuální větev je předvybraná) a necháš tour napsat.
Tour vlastní větve před mergem
Ve svém repozitáři stačí tour — nabídne větve oproti výchozí, případně aktuální větev i s necommitnutými změnami. Umíš si vybrat i jinak: tour feature/x, tour <commit>, tour <base>..<head> nebo uloženou tour tour soubor.json (tour jde sdílet s kolegy jako JSON soubor). V prohlídce se pohybuješ šipkami → a ←, o otevře kód kroku v editoru (zná vim, VS Code, Cursor, Zed i další) a q ukončuje.
Review workflow před mergem: čtvrthodina navíc
Samotný nástroj nestačí — potřebuješ rituál. Tohle je workflow, který si z diff-touru odnášíme:
Začni záměrem, ne diffem
První kroky tour odpovídají na otázku „k čemu změna je a kde se vyplatí číst pozorně". Teprve pak skoč do souborů. U agentova kódu je rozpor mezi záměrem a implementací častější než chyba v syntaxi.
Projdi kroky a sleduj štítky
U každého tvrzení čti label. Verified bereš jako fakt, Senior view jako podnět k vlastnímu úsudku. Když tour označí místo jako rizikové jen „ze seniorní zkušenosti", ověř ho v kódu sám.
Na nejasný krok se ptej klávesou ?
„Co když tohle spadne?", „kde se tohle volá ještě?", „projde rollback?" — odpovědi se ukládají do tour, takže kolega, který ji otevře po tobě, je uvidí taky.
Kritická místa otevři v editoru
Klávesa o tě hodí přímo na řádek v reálném kódu. Tour je vysvětlení, ne garance — autoři to říkají explicitně: ověř, co říká, proti kódu, který ukazuje.
Rozhodni se: merge, nebo konkrétní námitky
Výstup není „LGTM", ale buď merge, nebo request changes s body odkazujícími na kroky tour. Pokud review řešíte v týmu a agentů přibývá, podívej se i na stacked PR workflow a čtyřvrstvý review proces pro záplavu AI kódu — diff-tour zapadá do lidské vrstvy, kam jinak nic rozumného nesahá.
Bezpečnost: co tvůj kód sdílí a co ne
Poslat kód LLM je reálné rozhodnutí, takže autoři dokumentují přesně, co se děje. Tour je read-only: exportované soubory putují do dočasného adresáře v cache, LLM dostane jen je — nemůže číst tvůj pracovní strom, .git ani home adresář, nemůže nic zapisovat, spouštět příkazy, sahat na síť ani používat MCP servery. Soubory z .gitignore (třeba .env) se neexportují vůbec. Po napsání tour se exportní adresář smaže a nástroj sám neposílá žádnou telemetrii — data jdou jen do poskytovatele CLI, kterého jsi zvolil, podle podmínek tvého účtu.
U Claude Code se to vynucuje přímo příznaky procesu: claude -p --restricted --strict-mcp-config --tools Read,Grep,Glob --permission-mode dontAsk — tedy jen tři čtecí nástroje a nic jiného. Prompt injection v kódu pořád může ovlivnit, co model napíše, ale s těmito oprávněními nemůže nic udělat. Proto platí bod 4 z workflow: výstup ověřuj proti kódu.
Kolik to stojí a kde jsou limity
diff-tour neúčtuje nic sám — jede na tvém existujícím předplatném nebo API klíči. Podle FAQ v dokumentaci (říjen 2026) stála jedna tour změny o ~250 řádcích přes Claude Code ekvivalent 1,00 až 1,50 dolaru v API cenách; opětovné otevření uložené tour je zdarma. U denního review jednoho agentova PR je to zanedbatelné, u deseti paralelních agentů už si cenu pohlídej — stejně jako u nákladů na Claude Code obecně.
Limity, které je fér znát předem:
- Čeština zatím chybí — tour umí anglicky, japonsky, čínsky a španělsky. Jazyk vybereš v
tour setup, výstup bude nejspíš anglický. - Early release — formát tour i obrazovky se můžou měnit, Windows build je netestovaný a podpora Gemini CLI a Copilot CLI je experimentální.
- Není to nástroj na jednořádkový fix — tam je čtení diffu rychlejší. diff-tour dává smysl u nových featur, refaktoringů a agentova kódu, který teď máš vlastnit ty.
- Databázová schémata před a po změně umí jen pro SQLite migrace.
Časté otázky
Musím mít Claude Code, aby diff-tour fungoval?
Ne. diff-tour umí pracovat s Claude Code, Codex CLI, Gemini CLI, OpenCode 2 a Copilot CLI — stačí jedno z nich, nainstalované a přihlášené. Nejstabilnější je v současnosti podpora Claude Code a Codex; Gemini a Copilot jsou označené jako experimentální.
Kolik stojí jedna prohlídka diffu?
Podle dokumentace z října 2026 vychází tour změny o zhruba 250 řádcích na ekvivalent 1,00–1,50 dolaru v API cenách Claude Code. Jede to z tvého existujícího tarifu nebo API klíče a znovuotevření uložené tour nestojí nic.
Nahradí diff-tour automatické AI review nástroje?
Ne, řeší jiný problém. CodeRabbit, Greptile a podobné nástroje hledají chyby automaticky; diff-tour učí tebe rozumět změně, kterou máš schválit. V praxi se doplňují — AI review běží v CI, diff-tour použiješ u lidského review před mergem.
Posílá diff-tour můj kód na cizí server?
Kód čte LLM nástroj, který sis zvolil (například Claude Code), takže soubory putují do poskytovatele tohoto nástroje podle podmínek tvého účtu. diff-tour sám žádný server nemá, telemetrii nesbírá, a LLM dostane jen exportované soubory v izolovaném adresáři — nikdy .env ani jiné soubory z .gitignore.
Umí diff-tour česky?
Zatím ne. K 17. říjnu 2026 podporuje angličtinu, japonštinu, zjednodušenou a tradiční čínštinu a španělštinu. Tour si necháš vygenerovat anglicky — pro čtení diffu to obvykle nevadí, ale počítej s tím.
Závěr: merguj jen to, čemu rozumíš
Kontrola kódu od AI agenta není o tom číst rychleji, ale číst vedeně. diff-tour ti místo holého diffu nabídne prohlídku s kontextem, otázkami a štítky spolehlivosti — za cenu pár minut a zhruba dolaru na změnu. Nainstaluj ho, projdi si ukázkovou tour na example repozitáři a příště, když agent odevzdá tři sta řádků, dej si před zeleným tlačítkem čtvrthodinu navíc. Rozdíl mezi „vypadá to dobře" a „vím, co to dělá" je přesně ta hranice, která rozhoduje, jestli tě agent zrychlí, nebo připraví o víkend.
