CLI 인터페이스

기준일: 2026-07-26
난이도: 초급
공식 기준: CLI 인터페이스

개요

Hermes CLI는 웹 UI가 아닌 풀 터미널 UI입니다. 멀티라인 편집, 슬래시 자동완성, 대화 이력, 중단·리다이렉트, 스트리밍 툴 출력을 제공합니다. 모던 TUI는 hermes --tui.

첫 설정: hermes setup --portal 후 hermes chat.

핵심 개념

요소	설명
Status bar	모델·토큰·비용·압축 횟수·백그라운드·YOLO
Busy input	interrupt / queue / steer
Quick commands	LLM 없이 즉시 shell/alias
Background	/background 격리 세션
Resume	-c / --resume SQLite 복원

상세

실행

hermes
hermes chat -q "Hello"
hermes chat --model "anthropic/claude-sonnet-4"
hermes chat --provider nous
hermes chat --toolsets "web,terminal,skills"
hermes -s hermes-agent-dev,github-auth
hermes --continue
hermes --resume <session_id>
hermes chat --verbose
hermes -w
hermes -w -z "Fix issue #123"

상태 바

모델명, 토큰 used/max, 컨텍스트 바(색: 녹 <50% / 황 50–80% / 주 80–95% / 적 ≥95%), 비용, 🗜️ 압축 횟수, ▶ 백그라운드 수, 경과, ⚠ YOLO. 폭에 따라 full/compact/minimal.

/usage로 상세. openai-codex는 banked usage-limit reset (/usage reset, 조기 사용 방지, --force 가능).

키바인딩

키	동작
Enter	전송
Alt+Enter / Ctrl+J / Shift+Enter	줄바꿈 (터미널 호환 주의)
Alt+V / Ctrl+V	이미지·텍스트 붙여넣기
Ctrl+B	음성 녹음 (voice 모드)
Ctrl+G / Ctrl+X Ctrl+E	$EDITOR
Ctrl+C	중단 (2초 내 두 번 강제 종료)
Ctrl+D	종료
Ctrl+Z	Unix suspend → fg
Tab	자동완성

슬래시·스킬·성격

/help, /model, /tools, /skills browse, /background, /skin, /voice, /reasoning, /title, /status, /sessions 등. 설치 스킬은 /skill-name으로 등록. /personality pirate 등 빌트인·커스텀.

Quick commands

quick_commands:
  status:
    type: exec
    command: systemctl status hermes-agent
  restart:
    type: alias
    target: /gateway restart

Busy 입력 모드

display:
  busy_input_mode: "interrupt"  # queue | steer

세션 중 /busy queue|steer|interrupt|status.

세션·압축

저장: ~/.hermes/state.db. 압축:

compression:
  enabled: true
  threshold: 0.50

백그라운드

/background <prompt> → 별도 데몬 스레드 세션, 완료 시 패널 표시.

Quiet 모드

기본 quiet — 디버그는 hermes chat --verbose.

체크리스트

• 공식 원문과 명령·설정 키를 대조했다
• 로컬/config.yaml/.env에서 재현 경로를 확인했다
• 권한·allowlist·시크릿 노출을 점검했다
• 실패 시 롤백·비활성화 방법을 알고 있다

다음 단계

• 공식 문서: CLI 인터페이스
• Hermes Agent 소개
• 메시징 게이트웨이

---

기준일: 2026-07-26 — 공식 문서 동기화 코퍼스