TUI 소개: Hermes의 새로운 얼굴

클래식 커맨드라인 인터페이스로 Hermes를 사용해 오셨다면, 다음 소식이 마음에 드실 거예요. TUI(터미널 사용자 인터페이스)는 이제 Hermes를 대화형으로 실행하는 새로운 권장 방식입니다. 완성도와 사용성 면에서 확실한 업그레이드죠.

익숙한 Hermes 그대로라고 생각하면 됩니다. 다만 더 깔끔하고 반응성 좋은 화면으로 만난다고 보시면 돼요. 같은 에이전트, 같은 세션, 같은 슬래시 명령어. 그저 훨씬 나은 화면일 뿐입니다.

TUI가 특별한 이유는?

TUI는 단순히 클래식 CLI를 예쁘게 꾸민 게 아닙니다. 일상적인 작업 흐름을 더 매끄럽게 만들어 주는 실질적인 개선이 담겨 있어요:

즉각적인 첫 화면 — 앱 로딩이 끝나기 전에 배너가 나타나서, 시작 중에 터미널이 멈춘 듯한 느낌이 없습니다.
비차단 입력 — 세션이 준비되기 전에도 메시지를 입력하고 대기열에 넣을 수 있어요. 에이전트가 온라인이 되는 순간 첫 프롬프트가 전송됩니다.
풍부한 오버레이 — 모델 선택기, 세션 선택기, 승인 프롬프트 등이 지저분한 인라인 흐름 대신 깔끔한 모달 패널로 표시됩니다.
라이브 세션 패널 — 도구와 스킬이 초기화되는 과정이 점진적으로 채워지는 모습을 실시간으로 볼 수 있어요.
마우스 지원 — 드래그하면 균일한 배경색으로 텍스트가 강조됩니다. 터미널의 일반적인 제스처로 복사하면 됩니다.
깜빡임 없음 — 차등 업데이트 덕분에 스트리밍이 부드럽고, 종료 후 스크롤백이 지저분하게 남지 않습니다.

TUI 실행하기

시작은 간단합니다. --tui 플래그만 추가하면 돼요:

# TUI 실행
hermes --tui

# 최신 세션 이어가기
hermes --tui -c

# ID 또는 제목으로 특정 세션 이어가기
hermes --tui -r 20260409_000000_aa11bb
hermes --tui --resume "my t0p session"

# 특정 프로젝트의 최신 세션 이어가기
hermes --tui --resume latest --in ./my-project

환경 변수로도 활성화할 수 있습니다:

export HERMES_TUI=1
hermes          # 이제 TUI로 실행됨

또는 ~/.hermes/config.yaml에서 영구 기본값으로 설정할 수도 있어요:

display:
  interface: tui   # "cli" (기본값) 또는 "tui"

display.interface: tui로 설정하면 그냥 hermes만 입력해도 TUI가 실행됩니다. 하지만 명시적인 플래그가 항상 우선하니, hermes --cli를 실행하면 단일 세션 동안 클래식 REPL로 돌아갈 수 있어요.

접을 수 있는 배너 섹션

가장 마음에 드는 디테일 중 하나: 시작 배너의 런타임 정보가 이제 네 개의 접을 수 있는 섹션으로 그룹화되며, 각 섹션에는 ▸ / ▾ 토글 표시가 있습니다:

섹션	기본 상태
도구(Tools)	펼침
스킬(Skills)	접힘
시스템 프롬프트(System Prompt)	접힘
MCP 서버(MCP Servers)	접힘

섹션 헤더를 클릭하면 펼치고 접을 수 있어요. 도구 목록은 시작 시 가장 많이 확인하는 섹션이라 기본적으로 펼쳐져 있습니다. 스킬, 시스템 프롬프트, MCP 서버는 접힌 상태로 유지되어 배너가 컴팩트하게 보입니다. 스킬을 수십 개 설치했더라도 말이죠.

키 바인딩 및 슬래시 명령어

좋은 소식: 키 바인딩은 클래식 CLI와 완전히 동일합니다. 차이점은 전부 개선된 부분뿐이에요:

마우스 드래그 — 균일한 선택 배경색으로 텍스트가 강조됩니다
Cmd+V / Ctrl+V — 먼저 텍스트 붙여넣기를 시도하고, 실패하면 클립보드 읽기로, 마지막으로 이미지 첨부로 대체됩니다
Ctrl+X — 라이브 세션 전환기를 엽니다
Ctrl+G — 현재 입력 내용을 $EDITOR에서 열어 긴 프롬프트를 작성할 수 있습니다

모든 슬래시 명령어는 변경 없이 그대로 작동합니다. 일부는 더 풍부한 오버레이로 표시되는데, 예를 들어 /help는 분류된 명령어 패널을 보여줍니다.

요구 사항

Node.js ≥ 20이 필요합니다. TUI는 Python CLI에서 실행되는 하위 프로세스로 동작하기 때문이에요. hermes doctor가 이를 확인해 줍니다. 첫 실행 시 Hermes가 TUI의 Node 의존성을 설치합니다(일회성, 몇 초 소요). 이후 실행은 빠릅니다.

클래식 CLI는 여전히 기본 제공 방식이므로 언제든지 되돌아갈 수 있어요. 하지만 TUI를 한번 써보면, 예전으로 돌아가고 싶지 않을지도 모릅니다.