Wiki · Funkce do hloubky
TUI — práce v terminálu
Nejpohodlnější cesta k agentovi na serveru: přehled o běžící práci, stavový řádek a rozhovory, ke kterým se dá vrátit i po výpadku spojení.
⌨️
TUI je terminálové rozhraní pro toho samého agenta.
Stejné rozhovory, stejné příkazy lomítkem jako dřív — jen s lepším rozvržením, stavovým
řádkem a přehledem o běžících pomocnících. Pro práci na serveru je to nejpohodlnější cesta.
Spuštění
❯ hermes --tui # otevřít TUI
❯ hermes --tui -c # navázat na poslední rozhovor
❯ hermes --tui --resume latest # totéž delším zápisem
❯ hermes --tui -r 20260409_000000_aa11bb # podle identifikátoru
❯ hermes --tui --resume "můj projekt" # podle názvu rozhovoru
Můžete si ho zapnout i natrvalo — buď proměnnou prostředí, nebo v nastavení. Explicitní
příznak vždycky vyhraje (jednorázově se do klasického režimu vrátíte přes hermes --cli):
# dočasně pro toto okno
❯ export HERMES_TUI=1
# nebo natrvalo v ~/.hermes/config.yaml
display:
interface: tui
Proč ho používat
| Výhoda | Co to znamená v praxi |
|---|---|
| Okamžité první vykreslení | Úvodní obrazovka je na místě dřív, než se všechno načte — terminál nepůsobí zaseknutě |
| Živý přehled o práci | Dole vidíte, kolik běží pomocníků a jaké procesy agent spustil na pozadí |
| Stavový řádek | Píše, co agent právě dělá (ready, thinking…, running…) a jak se jmenuje rozhovor |
| Bohatší příkazy lomítkem | Některé příkazy umí v TUI přehledovou tabulku nebo výběr z nabídky místo výpisu do textu |
Příkazy lomítkem, které v TUI vypadají líp
| Příkaz | Co udělá |
|---|---|
/help | Přehled příkazů po skupinách, ovládaný šipkami |
/sessions (nebo /switch) | Přepínač otevřených rozhovorů — přepnutí, zavření, nový |
/model | Výběr modelu podle poskytovatele, včetně orientační ceny |
/usage | Přehled o spotřebě: tokeny, náklady, zaplnění kontextu |
/agents (nebo /tasks) | Strom běžících pomocníků s možností zastavit je a s přehledem nákladů |
/details | Zapnutí podrobných výpisů volání nástrojů (pro celý běh nebo jen pro jednu část) |
/skin | Změna vzhledu s živým náhledem |
/reload | Znovu načte ~/.hermes/.env — nové klíče platí bez restartu |
/mouse | Nastavení sledování myši (viz past s tmux níž) |
Klávesy
| Klávesa | Co udělá |
|---|---|
Ctrl+T | Rozbalí přehled běžící práce na celou obrazovku (pomocníci a procesy) |
Ctrl+R | Přepne přehled mezi podrobným a jednou shrnující řádkou |
Enter nebo t | V přehledu otevře živý přepis zvoleného pomocníka |
d / e / x | Podrobnosti / vstoupit do práce / zastavit zvoleného pomocníka |
Na macOS se funkční klávesa F7 (v některých terminálech záložní
zkratka k Ctrl+R) nemusí předávat — MacBooky ji mají nastavenou na ovládání
systému. Držte Fn (klávesa se zeměkoulí) nebo použijte Ctrl+R.
Když vypadne spojení
Na serveru přes SSH se spojení občas utrhne. Dá se nastavit, aby se TUI po spuštění sám vrátil k poslednímu rozhovoru:
❯ export HERMES_TUI_RESUME=1 # vždy navázat na poslední rozhovor TUI
❯ export HERMES_TUI_RESUME=<id> # nebo na konkrétní rozhovor
Pasti z našeho provozu
| Co se stalo | Co s tím |
|---|---|
| V tmuxu se nad psacím polem pořád objevovalo „No image in clipboard“ | Sledování myši posílalo terminálu události, kterým tmux nerozuměl. Pomohl režim /mouse wheel (kolečko funguje, ale bez najíždění kurzoru) |
| Na malém terminálu zbylo na psaní málo místa | Přehled běžící práce se přizpůsobuje výšce okna; pomáhá Ctrl+R (jedna shrnující řádka) nebo práce v novém okně terminálu |
| Příkaz spadl na chybě v Pythonu, přitom systém je v pořádku | Když se pouští systémové nástroje z prostředí, které si nese vlastní Python, dědí se cesty ke knihovnám. Pomáhá spouštět je s čistým prostředím (env -u PYTHONPATH) |
| Po úpravě nastavení se nic nezměnilo | Nový klíč v .env platí po /reload; co je v config.yaml, se načítá při startu rozhovoru |
| Přepnul jsem na TUI a nešlo se vrátit | Jednorázově hermes --cli, natrvalo změnit display.interface v nastavení |
Naše tipy
| Tip | Proč |
|---|---|
Rozhovory si pojmenujte (/title) | V přepínači i v navazování se pak hledá mnohem líp |
| Dlouhé úlohy pouštějte na pozadí | V TUI vidíte, co běží, a můžete mezitím zadávat další práci |
| Na serveru používejte tmux nebo screen | Když spojení vypadne, práce i agent zůstanou běžet |
| Sledujte stavový řádek | thinking… znamená, že agent pracuje — nemusíte psát další dotaz „tak co?“ |