hermes –tui în Hermes Agent CLI

hermes --tui [-c | -r <id|titlu>] [--in <dir>] [--dev]

Ce face hermes --tui

TUI-ul este interfața modernă de terminal a lui Hermes, peste același runtime Python ca CLI-ul clasic: aceleași sesiuni și aceleași comenzi slash. Documentația îl numește modul recomandat pentru lucru interactiv, dar CLI-ul clasic rămâne implicit. Necesită Node.js ≥ 20; la prima pornire instalează dependențele în ui-tui/node_modules.

Primul cadru apare imediat și poți scrie înainte ca sesiunea să fie gata. Selectorii de model și sesiuni, aprobările și întrebările apar ca panouri modale, selecția cu mouse-ul are fundal uniform, iar randarea pe ecranul alternativ nu lasă text în scrollback după ieșire. Ctrl+X deschide comutatorul de sesiuni live, Ctrl+T extinde panoul cu subagenți și procese, iar Ctrl+G deschide promptul în $EDITOR.

Câteva comenzi sunt specifice TUI: /details (detalii despre apelurile de unelte), /mouse (urmărirea mouse-ului, salvată în display.mouse_tracking), /terminal-setup (legături de taste pentru terminalele din VS Code, Cursor și Windsurf) și /connectors. Ca TUI-ul să fie implicit, setează display.interface: tui; hermes --cli revine la REPL-ul clasic pentru o invocare.

Sintaxă și opțiuni

Opțiune / Parametru	Descriere
--tui	Pornește TUI-ul. Are prioritate față de display.interface.
-c, --continue / --resume latest	Reia ultima sesiune TUI (dacă nu există, ultima sesiune clasică).
-r, --resume <id|titlu>	Reia o sesiune anume.
--in <dir>	Ultima sesiune a directorului dat.
--dev	Rulează sursele direct, fără bundle-ul precompilat (pentru contribuitori).
HERMES_TUI=1	Variabilă de mediu: hermes și hermes chat pornesc TUI-ul.
HERMES_TUI_DIR	Director cu un bundle precompilat (trebuie să conțină dist/entry.js).
/mouse [on|off|toggle|wheel|buttons|all]	Presetul de urmărire a mouse-ului; wheel păstrează derularea fără evenimentele de hover care deranjează tmux.

Exemple practice

Exemplul 1: Pornirea TUI-ului

hermes --tui

Exemplul 2: Ultima sesiune a unui proiect

hermes --tui --resume latest --in ./my-project

Exemplul 3: TUI implicit din config

În ~/.hermes/config.yaml:

display:
  interface: tui   # "cli" (implicit) sau "tui"

Greșeli frecvente și bune practici

• Cauți un flag --native pentru scrollback-ul terminalului. Nu există; în tmux sau în terminale integrate folosește /mouse wheel.
• Rulezi TUI-ul fără Node.js ≥ 20. hermes doctor verifică această cerință.
• Folosești /sessions în TUI pentru conversații vechi. Acolo arată doar sesiunile live din procesul curent; transcrierile salvate se deschid cu /resume.

Comenzi înrudite

• hermes
• hermes-resume
• hermes-slash-resume
• hermes-comenzi-slash