Asistent AI

Asistent uvnitř editoru, který řídí agenta AI na příkazové řádce, jehož už máte nainstalovaného — vysvětlování, refaktorování, opravy, psaní testů, shrnutí, překlad i chat, přičemž každá navržená úprava se ukazuje jako rozdíl ke kontrole, který uplatníte záměrně.

Přineste si vlastního agenta

Asistent vás nežádá o klíč API a nikam vás nepřihlašuje. Místo toho spouští jako pomocníka místně nainstalovaného agenta AI na příkazové řádce a jeho výstup streamuje do editoru. Ověřování, vaše předplatné i volba modelu patří tomu nástroji.

• Dnes: Claude Code (claude) a Codex CLI (codex). Nainstalujte jeden z nich a jednou se přihlaste (aby claude nebo codex fungoval z terminálu); editor jej převezme automaticky. Nabízí se i Gemini, jeho propojení s příkazovou řádkou ale zatím není ověřené.
• Rozpoznávání je automatické a neblokující. Editor agenta zjišťuje na pozadí hned po spuštění — okno na něj nikdy nečeká. Během zjišťování je Zobrazit → Chat s AI krátce vypnuté s nápovědou Zjišťuji AI engine…; o pár vteřin později se buď zapne (agent nalezen), nebo zůstane zašedlé s nápovědou, co nainstalovat.

Agent je samostatný program, který si nainstalujete

Editor žádného agenta AI nedodává ani nestahuje a sám nikam neodesílá váš text — požadavek podává agent na příkazové řádce, kterého jste nainstalovali, a to pod svým účtem a přes své síťové připojení. Není-li agent nainstalovaný nebo přihlášený, funkce AI prostě zůstanou vypnuté a nic jiného v editoru to neovlivní.

Požadavky

Asistent má jediný tvrdý požadavek: podporovaného agenta AI na příkazové řádce, nainstalovaného a přihlášeného ve vaší systémové PATH.

• Nainstalujte podporovaného agenta. Dnes je to Claude Code (claude) nebo Codex CLI (codex).
• Jednou se přihlaste. Spusťte agenta z terminálu a dokončete jeho vlastní přihlášení, aby poté fungoval bez obsluhy. Editor si nikdy nežádá ani neukládá klíč API — vaše předplatné i přihlášení bydlí výhradně v tom nástroji.
• Zajistěte, aby byl ve vaší PATH. Pokud jej editor nemůže spustit, je Zobrazit → Chat s AI zašedlé s vysvětlující nápovědou.

Panel Chat s AI

Žádná nabídka AI nejvyšší úrovně neexistuje — vše bydlí v jediném spodním panelu, přepínaném z Zobrazit → Chat s AI. Byl-li panel otevřený, když jste editor naposledy zavřeli, otevře se znovu při dalším spuštění (jakmile je engine rozpoznán).

Odshora dolů panel ukazuje:

• rozbalovací seznam Engine (vaše volba se pamatuje mezi relacemi) a zaškrtávací pole Povolit úpravy souborů (viz níže);
• stavový řádek — rozpoznaný engine a verzi, poznámku o zjišťování či průběhu, nebo nápovědu »nainstalujte a přihlaste se«. Po první odpovědi jmenuje také model, který agent skutečně použil, například Engine: Claude (2.1.200) · claude-sonnet-5 — stojí za pohled, protože model rozhoduje o tom, co vás běh stojí (viz Volba modelu);
• tenký pruh činnosti s tlačítkem Zastavit, dokud agent pracuje;
• konzoli — celý rozhovor v jednom zobrazení;
• řádek nápovědy se seznamem dostupných příkazů jako klikatelných odkazů.

Konzole

Rozhovor funguje jako terminál: historie nahoře a vy píšete na konci, za výzvou ›.

• Enter odesílá; Shift+Enter vkládá zalomení řádku, takže víceřádkové dotazy fungují.
• Kliknutím nebo psaním kdekoli v historii se kurzor vrátí k výzvě — historie je vybíratelná a kopírovatelná, ale nikdy upravitelná.
• Esc zruší běžící požadavek; když nic neběží, vymaže to, co jste za › napsali. Esc funguje se zaměřením kdekoli v panelu.
• Ctrl+A vybere pouze dotaz, který právě skládáte, takže to, co napíšete dál, jej nahradí; když nemáte nic napsáno, vybere místo toho celý přepis připravený ke kopírování.
• Nahoru a Dolů vyvolávají, na co jste se ptali dřív, jak je zvykem v shellu. Nahoru na prvním řádku toho, co píšete, kráčí zpět vašimi dřívějšími dotazy; Dolů jde zase vpřed a krok za ten nejnovější vrátí zpět rozepsaný řádek, od kterého jste vyšli. Uvnitř víceřádkového dotazu se prostě pohybují mezi jeho řádky, a jakmile vyvolaný dotaz upravíte, stane se vaším novým konceptem. Historie je vlastností panelu a mezi relacemi se neuchovává.
• Zatímco odpověď proudí dovnitř, zobrazení ji sleduje, jste-li dole; posunete-li se nahoru ke čtení, zůstane stát. Až je odpověď kompletní, zobrazení ji umístí záměrně: krátká odpověď se posune dolů, abyste viděli ji i výzvu pod ní, zatímco u dlouhé se nadpis Asistent zarovná s horním okrajem panelu, abyste mohli číst od začátku.
• Markdown každé odpovědi se vykresluje samostatně, takže číslované seznamy začínají pokaždé od 1, místo aby pokračovaly v číslování předchozí odpovědi.

Příkazy

Napište příkaz na výzvu, nebo na něj klikněte v řádku nápovědy (příkazy přijímající argument dostanou koncovou mezeru a počkají, až řádek dokončíte):

Příkaz	Co dělá	Výsledek
.explain	Vysvětlí vybraný kód	odpověď v chatu
.summarize	Shrne vybraný text	odpověď v chatu
.refactor <how>	Refaktoruje podle pokynu (například .refactor extract a helper)	úprava ke kontrole
.fix	Opraví vybraný kód	úprava ke kontrole
.tests	Napíše jednotkové testy pro výběr	úprava ke kontrole
.translate <language>	Přeloží výběr (například .translate German)	úprava ke kontrole
.model <id>	Připne model, o který tento editor žádá (viz Volba modelu)	odpověď okamžitě, bez spuštění agenta

S čímkoli dalším, co napíšete, se zachází přirozeně:

• Prostý text je volný dotaz agentovi, odeslaný spolu s tím, co máte na obrazovce (viz níže).
• Řádek začínající / je jeden z vlastních příkazů agenta (jako Claudovo /help) a předává se přesně tak, jak je napsán — nic z editoru se k němu nepřidává a není potřeba žádný souhlas, protože se nic vašeho neodesílá. Platí to pro enginy, jejichž sada příkazů byla ověřena — dnes Claude; u ostatních se řádek s / považuje za obyčejný dotaz.
• Nerozpoznané .slovo není chyba; pošle se dál jako dotaz.

Ne každý příkaz příkazové řádky zde znamená totéž co ve vlastním terminálu agenta: některé potřebují interaktivní relaci, jakou běhy editoru nemají, některé se týkají rozhovorů, které si editor už spravuje sám, a některé — jako /model — prostě nemohou přežít jediný požadavek. Když takový pošlete, editor jej přesto předá a přidá krátkou poznámku, proč nemusí udělat, co čekáte. Každou poznámku uvidíte jednou za relaci.

Vlastní /model agenta se nemůže udržet — použijte .model

Každý dotaz spouští agenta nanovo a čerstvý běh vždy začíná modelem, který má vaše příkazová řádka nastavený. /model … odpoví »Nastaven model … pouze pro tuto relaci«, jenže ta relace končí ve chvíli, kdy končí odpověď: další dotaz — i takový, který pokračuje v témže rozhovoru — je zpět na nastaveném modelu. Použijte místo toho .model <id>; je to vlastní příkaz editoru a připne model pro každý další dotaz. Viz Volba modelu.

Na velikosti písmen při porovnávání nezáleží a řádek nápovědy se během psaní zužuje (.r → .refactor …).

Výběr, nebo celý dokument

Příkazy pracují s aktuálním výběrem. Bez výběru působí na celý dokument — a protože to odesílá agentovi celý soubor, editor se nejprve zeptá: Odeslat celý dokument „…“ do Claudea? Dotázáni jste jednou za dokument a relaci editoru; odmítnutím se odeslání zruší a to, co jste napsali, zůstane. Otázku lze vypnout v Předvolby → Asistent AI volbou Zeptat se před odesláním celého dokumentu do AI enginu; je-li vypnutá, odešle se celý dokument bez ptaní.

Co asistent ví o vašem dokumentu

Agent čte soubory z disku. Sám o sobě by tedy na dotazy ohledně souboru, který jste upravili, ale neuložili, odpovídal ze starého textu a nepojmenovaný buffer by neviděl vůbec. Volný dotaz mu proto řekne, co máte doopravdy otevřeno:

• Uložený bez neuložených změn — asistent prostě soubor pojmenuje a nechá agenta, ať si jej přečte. Z editoru nic neodchází, takže se na nic neptá.
• Neuložené změny, nebo nikdy neuložený dokument — aktuální text se odešle spolu s vaším dotazem. Malé dokumenty putují přímo v dotazu; větší se zapíšou do dočasné kopie, na kterou se agent nasměruje. Kopie se smaže, jakmile výměna skončí.
• S otevřenou složkou — každý další otevřený dokument s neuloženými změnami se přiloží stejně, takže agent vidí projekt tak, jak jej vidíte vy, nikoli jak byl naposledy uložen.

Protože to odesílá text ven, editor se nejprve zeptá — jednou za dokument a relaci editoru a jednou za celý požadavek, i když jde o několik dokumentů: Do Claudea bude odeslán aktuální, neuložený obsah těchto dokumentů: …. Pokračovat? Odmítnutím se požadavek opustí a to, co jste napsali, zůstane.

Výběr má stále přednost jako věc, na kterou ukazujete: odešle se jako Relevantní výběr vedle dokumentu, nikoli místo něj.

Ve výchozím režimu jen ke čtení se agentovi navíc řekne, že váš dokument měnit nemůže a že změnu má navrhnout příkazy .refactor, .fix, .tests a .translate — které vám rozdíl ukážou.

Kontrola a uplatnění úprav

Editační příkazy váš text nikdy nepřepisují mlčky. Když agent skončí, otevře se okno ke kontrole s jednou zaškrtávatelnou, obarvenou skupinou změn na každou úpravu — odebrané řádky červeně, přidané zeleně:

• odškrtněte změny, které nechcete;
• Použít nahradí výběr (nebo celý dokument, jde-li o případ bez výběru) pouze přijatými změnami;
• Zahodit ponechá buffer přesně tak, jak byl.

Uplatněné změny jsou obyčejné úpravy, takže je Ctrl+Z vrátí jako cokoli jiného. Styl konců řádků vašeho souboru (CRLF/LF) zůstává zachován. Pokud agent úpravu odmítne udělat, objeví se jeho vysvětlení jako běžná odpověď v chatu místo falešného rozdílu.

Pokud jste během práce agenta upravovali dál, editor nikdy nevloží zastaralou změnu přes váš novější text. Co udělá místo toho, závisí na tom, co ještě umí říct s jistotou:

• vaše psaní cíl posunulo, ale nechalo jej nedotčený → změna se uplatní tam, kde text je teď;
• příkaz se týkal celého dokumentu a dokument se mezitím změnil → návrh se porovná s vaším aktuálním textem a vy kontrolujete tento rozdíl, takže odpověď nepřijde nazmar;
• původní text je pryč, nebo se nyní vyskytuje vícekrát → editor raději odmítne, než aby hádal, a řekne vám, ať příkaz spustíte znovu.

Barvy rozdílu se řídí vaším barevným motivem: motivy mohou definovat vyhrazené barvy Přidaný text v rozdílu / Odebraný text v rozdílu (upravitelné v Předvolby → Obarvování syntaxe → Motivy) a bez nich editor zvolí čitelné výchozí barvy pro světlé i tmavé rozhraní.

Rozhovory

Volné dotazy tvoří pokračující rozhovor: agent si pamatuje vaše předchozí dotazy i odpovědi. Na každou otevřenou složku připadá jeden rozhovor (nebo na soubor, není-li otevřená žádná složka), takže nesouvisející projekty si kontext nesdílejí. Editační příkazy (.refactor, .fix, …) běží záměrně jednorázově a kontext chatu neznečišťují. Rozhovory se neuchovávají — restart editoru začíná s čerstvými.

V rozhovorech pokračují Claude i Codex. Codex si každý rozhovor pojmenuje sám a název ohlásí na začátku; další dotazy na rozhovor navazují právě odtud. Skončí-li běh Codexu, aniž by název ohlásil, chat ukáže [v konverzaci nebylo možné pokračovat — engine neoznámil žádný identifikátor relace; další zpráva zahájí novou] — odpověď, kterou jste dostali, platí, ale váš další dotaz začne nový rozhovor bez dřívějšího kontextu.

Rozhovor přežije i to, co se pokazí. Zastavení odpovědi ji zachová, takže dotaz, který jste přerušili, lze prostě zase zvednout — zeptejte se »pokračuj v posledním úkolu« a agent pořád ví, co dělal, i když jste jej zastavili dřív, než stačil cokoli říct. Ojedinělé selhání (limit počtu požadavků, přerušené spojení) také historii nezahodí; teprve druhé selhání v řadě začíná čerstvý rozhovor.

Zastavení běhu

Zatímco agent pracuje, objeví se pruh činnosti s tlačítkem Zastavit — klikněte na ně (nebo stiskněte Esc kdekoli v panelu) a běh zrušíte. Cokoli se dosud odvysílalo, zůstane v přepisu, běh se označí [Zrušeno] a žádná úprava se neuplatní. Rozhovor se zachová, takže váš další dotaz v něm pokračuje (viz Rozhovory). Stisk Enteru uprostřed běhu nic nezařadí do fronty; stavový řádek připomene, že agent stále pracuje.

Jak agentovi povolit úpravy souborů

Ve výchozím stavu je asistent jen ke čtení: každý běh spouští agenta s vypnutými nástroji pro úpravu souborů, přístupem k shellu i podřízenými agenty, takže se k vám změny dostávají výhradně jako návrhy ke kontrole. U enginů s ověřenými příznaky oprávnění je to tvrdá blokace vynucená samotným agentem, ať máte příkazovou řádku nastavenou jakkoli:

• Claude běží s vypnutými nástroji pro úpravu souborů, přístupem k shellu i podřízenými agenty.
• Codex běží ve svém sandboxu jen ke čtení (-s read-only). Sandbox funguje jinak: příkazy shellu nevypíná, ale uzavírá je — Codex smí dál spouštět příkazy, aby se rozhlédl, ty ale nemohou nic zapsat. Prozatím editor Codex navíc výslovně žádá, aby zůstal jen ke čtení.

Režim jen ke čtení není zaručen u každého enginu

Tvrdá blokace stojí na vlastních příznacích oprávnění enginu. Gemini zatím ověřené příznaky nemá, takže jej editor může jen požádat — jako pokyn s nejlepším úmyslem — aby zůstal jen ke čtení; vynutit to nedokáže. Berte režim jen ke čtení u Gemini jako nezaručený: na disk zapisovat může a jeho chování se nakonec řídí vlastním nastavením vaší příkazové řádky. Pokud vám na tom záleží, dělejte takovou práci ve složce pod správou verzí.

Zaškrtávací pole Povolit úpravy souborů (vedle rozbalovacího seznamu enginů, ve výchozím stavu vypnuté, pamatuje se mezi relacemi) přihlašuje k úpravám na straně agenta:

• úpravy souborů od agenta se automaticky přijímají a agent smí během běhu měnit soubory v otevřené složce;
• každý zápis se v rozhovoru ohlásí jako [agent upravil soubor: …] a otevřené dokumenty změny převezmou běžným sledováním souborů v editoru;
• když běh skončí, jediný souhrnný řádek vypíše úplnou sadu dotčených souborů s jejich počtem, například [upravené soubory (3): …];
• přístup Claude k shellu a jeho podřízení agenti zůstávají blokováni i se zapnutou volbou.

U Codexu volba přepne jeho sandbox na -s workspace-write: Codex pak smí upravovat soubory a spouštět příkazy shellu v otevřené složce a v dočasném adresáři. Codex své úpravy editoru nehlásí, takže chat nevypisuje soubory, které změnil, a souhrnný řádek chybí; otevřené dokumenty změny přesto převezmou sledováním souborů. Samotné zápisy provádí vlastní sandbox Codexu: odpoví-li Codex, že nedokázal spustit svůj spouštěč příkazů, tento sandbox na vašem počítači nefunguje — zkontrolujte jeho vlastní diagnostiku (codex doctor), ne editor.

Týž přepínač je i v Předvolby → Asistent AI jako Povolit AI enginu upravovat soubory. Jde o jedno nastavení, nikoli o dvě: uplatnění v Předvolbách ihned zaškrtne nebo odškrtne pole v panelu a to, co nastavíte v panelu, je to, co Předvolby ukážou, až je příště otevřete.

Dokumenty s neuloženými změnami jsou ošetřené za vás. Agent nesmí upravovat soubor na disku pro dokument, který jste změnili, ale neuložili — ta kopie je zastaralá a zápis do ní by způsobil, že by se soubor a váš editor rozcházely. Agent proto dostane k úpravě dočasnou kopii vašeho aktuálního textu a po skončení běhu editor výsledek vrátí do vašeho otevřeného dokumentu jako obyčejnou, vratnou úpravu. Nepojmenované dokumenty fungují stejně, i když žádný soubor nemají vůbec. Pokud jste dokument během práce agenta náhodou upravovali i vy, editor vás nepřepíše: otevře obvyklé okno ke kontrole proti vašemu aktuálnímu textu, abyste rozhodovali změnu po změně. Zavření dokumentu během běhu práci agenta prostě zahodí, s poznámkou v rozhovoru.

Povolení úprav souborů může vaši práci přepsat nebo smazat

Se zapnutou volbou agent zapisuje na disk přímo a tyto zápisy se automaticky přijímají — žádné okno ke kontrole jednotlivých změn neexistuje. Agent může soubory v otevřené složce přepsat, smazat nebo poškodit a úpravy souborů, které nemáte otevřené, se vám jako rozdíly neukazují. Zapínejte to jen pro složku pod správou verzí (Git, SVN, …): nejprve práci zakomitujte nebo odložte a pak si každou změnu prohlédněte v rozdílu ze správy verzí a cokoli nechtěného vraťte — berte správu verzí jako své Zpět pro úpravy agenta. Gemini, jehož příznaky oprávnění zatím nejsou ověřené, tuto volbu zcela ignoruje, takže se jeho úpravy řídí výhradně vlastním nastavením vaší příkazové řádky.

Přepínání enginů

Při spuštění editor hledá každý engine, který zná, a rozbalovací seznam Engine nabízí jen ty, které jsou na tomto počítači nainstalované. Pokud engine zvolený naposledy už není k dispozici, automaticky jej nahradí první nainstalovaný. Engine nainstalovaný za běhu editoru se objeví po restartu. Není-li nainstalovaný žádný engine, seznam nabízí všechny enginy, které editor zná, a panel zůstává zašedlý s nápovědou k instalaci a přihlášení.

Jiného agenta zvolíte kdykoli z rozbalovacího seznamu Engine (během aktivního běhu je vypnutý). Přepnutí zruší zjišťování předchozího enginu, zjistí na pozadí ten nový a začne čerstvé rozhovory — chat započatý s jedním enginem nemůže pokračovat s jiným. Přepnutí také vymaže přepis, protože ten rozhovor patřil jinému enginu; to, co jste napsali do vstupního řádku, zůstane.

Volba modelu

Ve výchozím stavu editor o model nežádá, takže každý běh použije to, co má nastavené váš agent na příkazové řádce — u Claude Code je to model ve vašem osobním ~/.claude/settings.json. To často není to, co chcete pro editor: je to globální předvolba, může se změnit, aniž byste si všimli, a model rozhoduje o tom, co který požadavek stojí.

Stavový řádek vám říká, co se skutečně použilo, takže si to můžete vždy ověřit. Chcete-li připnout model pro samotný editor, napište jej do chatu:

Napíšete	Co se stane
.model claude-sonnet-5	každý další dotaz žádá o tento model
.model	ohlásí připnutý model a zároveň model naposledy skutečně použitý
.model default	připnutí zruší; opět platí vlastní výchozí model agenta

.model obsluhuje editor — nikdy nespouští agenta, takže odpovídá okamžitě a nic nestojí. Připnutí se projeví od vašeho dalšího dotazu a stavový řádek to potvrdí, jakmile odpověď dorazí.

Totéž lze nastavit ručně, pro každý engine zvlášť, v souboru nastavení OctoEditu:

Klíč	Hodnota	Účinek
ai/model/<engine>	id modelu, například claude-sonnet-5	každý běh použije tento model
ai/model/<engine>	prázdné / chybí (výchozí)	vlastní výchozí model agenta

<engine> je id enginu tak, jak je uvedeno v rozbalovacím seznamu, malými písmeny — například ai/model/claude nebo ai/model/codex. Projeví se u dalšího požadavku panelu, poté si to ověřte ve stavovém řádku. Gemini, jehož příznak modelu zatím není ověřen, nastavení ignoruje.

Související pokročilé nastavení

ai/programPath/<engine> dělá totéž pro binárku: nastavte ji na absolutní cestu, když je agent nainstalován tam, kam hledání v PATH editoru nedohlédne. Oba klíče jsou záměrně nouzová vrátka pouze v souboru — chybná hodnota selže hlasitě, místo aby se tiše ignorovala.

Když běh selže

Skončí-li agent chybou, chat ukáže [agent exited with code N, za ním vlastní chybové řádky agenta a uzavírací ] — u Codexu jeho úvodní banner a jeho řádky ERROR: …, například 401 Unauthorized, které dostanete, když nejste přihlášeni. Obvykle to stačí k tomu, abyste poznali, co se pokazilo; zbytek vám řekne jedno spuštění agenta z terminálu.

Protokol editoru (mte.log, viz Protokolování a diagnostika) zaznamenává každý běh v řádcích začínajících AI: — které enginy byly nalezeny, program a argumenty každého běhu, jeho návratový kód a poslední chybové řádky agenta, když běh selže; spuštění editoru s --log=debug přidá zbytek diagnostického výstupu agenta. Váš dotaz ani odpověď se nikdy neobjeví v chybové zprávě a nikdy se nezapíší do protokolu: protokol uvádí jen velikost dotazu v bajtech.

Soukromí a náklady

Požadavky odesílá agent na příkazové řádce, kterého jste zvolili, pod svým účtem a přes své síťové připojení — editor nepřidává žádnou vlastní telemetrii ani koncové body. (Codex celou výměnu opakuje ve svém diagnostickém výstupu; editor tuto kopii zahodí a nikdy ji nezapíše do svého protokolu.) Co se odesílá (váš pokyn, váš výběr či dokument a neuložený text otevřených dokumentů, když to dotaz potřebuje) a co to stojí, se řídí předplatným nebo tarifem onoho agenta. Bez výše popsaného dotazu na souhlas z editoru neodchází nic a stavový řádek jmenuje model, který každý požadavek skutečně použil.

Co je dnes k dispozici

Příkazy pracují s aktuálním výběrem (nebo s celým dokumentem, se souhlasem) a po přijetí jej nahradí. Existují dvě úrovně pravomocí: výše popsaný postup jen ke čtení, kdy se pouze navrhuje, nebo výslovné přihlášení k Povolit úpravy souborů. Samostatná kontrola vlastních úprav agenta na disku v editoru neexistuje — se zapnutou volbou Povolit úpravy souborů se spolehněte na svou správu verzí; jedinou výjimkou je dokument otevřený s neuloženými změnami, jehož úpravy se vracejí přes editor.