TUI
TUI là front-end hiện đại cho Hermes — giao diện terminal được hỗ trợ bởi cùng Python runtime như CLI Cổ điển. Cùng agent, cùng sessions, cùng slash commands; một bề mặt sạch hơn, phản hồi nhanh hơn để tương tác.
Đây là cách được khuyến nghị để chạy Hermes tương tác.
Khởi chạy
# Khởi chạy TUI
hermes --tui
# Tiếp tục phiên TUI gần nhất
hermes --tui -c
hermes --tui --continue
# Tiếp tục phiên cụ thể theo ID hoặc tiêu đề
hermes --tui -r 20260409_000000_aa11bb
hermes --tui --resume "my t0p session"
# Chạy source trực tiếp — bỏ qua prebuild (cho TUI contributors)
hermes --tui --dev
Bạn cũng có thể bật qua biến môi trường:
export HERMES_TUI=1
hermes # bây giờ dùng TUI
hermes chat # tương tự
CLI cổ điển vẫn là mặc định. Mọi thứ trong Giao diện CLI — slash commands, quick commands, skill preloading, personalities, multi-line input, interrupts — đều hoạt động trong TUI tương tự.
Tại sao TUI
- Frame đầu tiên tức thì — banner hiển thị trước khi app tải xong, terminal không bao giờ cảm thấy đóng băng.
- Input không chặn — gõ và xếp hàng tin nhắn trước khi session sẵn sàng. Prompt đầu tiên gửi ngay khi agent online.
- Overlay phong phú — model picker, session picker, approval prompts render dạng modal panels.
- Panel session trực tiếp — tools và skills hiển thị dần khi khởi tạo.
- Chọn bằng chuột — kéo để highlight với nền đồng nhất. Copy bằng cử chỉ copy thông thường.
- Alternate-screen rendering — cập nhật vi phân, không nhấp nháy khi streaming, không rác scrollback sau khi thoát.
- Tiện ích composer — inline paste-collapse cho snippets dài,
Cmd+V/Ctrl+Vpaste text, hỗ trợ đính kèm ảnh/file.
Cùng skins và personalities áp dụng. Chuyển giữa phiên với /skin ares, /personality pirate. Xem Skins & Themes cho danh sách đầy đủ.
Yêu cầu
- Node.js ≥ 20 — TUI chạy như subprocess từ Python CLI.
hermes doctorkiểm tra điều này. - TTY — pipe stdin hoặc môi trường non-interactive fallback sang single-query mode.
Lần khởi chạy đầu tiên, Hermes cài dependencies Node vào ui-tui/node_modules (một lần, vài giây). Các lần sau nhanh. Khi pull phiên bản Hermes mới, TUI bundle tự động rebuild khi sources mới hơn dist.
Distributions có prebuilt bundle (Nix, system packages) có thể trỏ Hermes tới:
export HERMES_TUI_DIR=/path/to/prebuilt/ui-tui
hermes --tui
Thư mục phải chứa dist/entry.js và node_modules cập nhật.
Phím tắt
Phím tắt giống hệt CLI Cổ điển. Khác biệt duy nhất:
- Kéo chuột highlight text với nền selection đồng nhất.
Cmd+V/Ctrl+Vthử paste text trước, sau đó fallback clipboard reads, cuối cùng đính kèm ảnh./terminal-setupcài terminal bindings cho VS Code / Cursor / Windsurf.- Slash autocompletion mở dạng floating panel với mô tả.
Slash commands
Tất cả slash commands hoạt động không thay đổi. Một số là TUI-owned — output phong phú hơn hoặc render dạng overlay:
| Lệnh | Hành vi TUI |
|---|---|
/help | Overlay phân loại commands, điều hướng bằng phím mũi tên |
/sessions | Modal session picker — xem trước, tiêu đề, tổng token, tiếp tục inline |
/model | Modal model picker nhóm theo provider, có gợi ý chi phí |
/skin | Live preview — theme thay đổi khi duyệt |
/details | Toggle chi tiết tool-call trong transcript |
/usage | Panel token / chi phí / context phong phú |
Mọi slash command khác hoạt động giống CLI cổ điển. Xem Tham khảo Slash Commands.
Thanh trạng thái
Thanh trạng thái TUI theo dõi trạng thái agent real-time:
| Trạng thái | Ý nghĩa |
|---|---|
starting agent… | Session ID đã live; tools và skills đang khởi tạo. Bạn có thể gõ. |
ready | Agent rảnh, chấp nhận input. |
thinking… / running… | Agent đang suy luận hoặc chạy tool. |
interrupted | Turn hiện tại bị hủy; nhấn Enter để gửi lại. |
forging session… / resuming… | Kết nối ban đầu hoặc handshake --resume. |
Cấu hình
TUI tuân theo tất cả cấu hình Hermes chuẩn: ~/.hermes/config.yaml, profiles, personalities, skins, quick commands, v.v. Không có file config riêng cho TUI.
display:
skin: default # bất kỳ skin nào
personality: helpful
details_mode: compact # hoặc "verbose"
mouse_tracking: true # tắt nếu terminal xung đột
/details on / /details off / /details cycle toggle khi chạy.
Sessions
Sessions được chia sẻ giữa TUI và CLI cổ điển — cả hai ghi vào cùng ~/.hermes/state.db. Bạn có thể bắt đầu session ở một giao diện, tiếp tục ở giao diện khác.
Xem Sessions cho lifecycle, search, compression, và export.
Quay lại CLI cổ điển
Chạy hermes (không có --tui) vẫn dùng CLI cổ điển. Để máy ưu tiên TUI, đặt HERMES_TUI=1 trong shell profile. Để quay lại, bỏ biến.
Nếu TUI không khởi chạy được (thiếu Node, bundle, vấn đề TTY), Hermes in thông báo chẩn đoán và fallback.
Xem thêm
- Giao diện CLI — tham khảo đầy đủ slash command và phím tắt
- Sessions — tiếp tục, phân nhánh, và lịch sử
- Skins & Themes — tùy chỉnh banner, thanh trạng thái, và overlay
- Chế độ giọng nói — hoạt động trên cả hai giao diện
- Cấu hình — tất cả config keys