본문으로 건너뛰기

제품정보 제품 설명

anchor alias
anchor alias

제품정보 제품 설명

Hermes Agent의 CLI는 웹 UI가 아닌 전체 터미널 사용자 인터페이스(TUI)입니다. Multiline 편집, slash-command autocomplete, 대화 기록, 중단 및 간접 및 스트리밍 도구 출력을 특징으로 합니다. 맨끝에서 사는 사람들을 위해 건축하는.

Hermes는 또한 modal overlays, 마우스 선택 및 비 차단 입력을 가진 현대 TUI를 발송합니다. hermes --tui - [TUI] (tui.md) 가이드를 참조하십시오.

CLI 실행

# Start an interactive session (default)
hermes

# Single query mode (non-interactive)
hermes chat -q "Hello"

# With a specific model
hermes chat --model "anthropic/claude-sonnet-4"

# With a specific provider
hermes chat --provider nous # Use Nous Portal
hermes chat --provider openrouter # Force OpenRouter

# With specific toolsets
hermes chat --toolsets "web,terminal,skills"

# Start with one or more skills preloaded
hermes -s hermes-agent-dev,github-auth
hermes chat -s github-pr-workflow -q "open a draft PR"

# Resume previous sessions
hermes --continue # Resume the most recent CLI session (-c)
hermes --resume <session_id> # Resume a specific session by ID (-r)

# Verbose mode (debug output)
hermes chat --verbose

# Isolated git worktree (for running multiple agents in parallel)
hermes -w # Interactive mode in worktree
hermes -w -q "Fix issue #123" # Single query in worktree

공용영역 배치

Stylized preview of the Hermes CLI layout showing the banner, conversation area, and fixed input prompt.

<p className="docs-figure-caption">The Hermes CLI banner, conversation stream, and fixed input prompt rendered as a stable docs figure instead of fragile text art.</p>

환영 배너는 모델, 터미널 백엔드, 작업 디렉토리, 사용 가능한 도구 및 한 눈에 설치된 기술을 보여줍니다.

상태 바

persistent 상태 표시줄은 입력 영역의 위, 실시간 업데이트:

 ⚕ claude-sonnet-4-20250514 │ 12./ │ [██████░░░░] 6% │ $0.06 │ 15m
제품정보이름 *
모델명현재 모델(26개 이상의 숯이 부족한 경우)
토큰 수Context 토큰 사용 / 최대 컨텍스트 창
Context 바Color-coded 임계값을 가진 Visual Fill 지표
제품정보예상된 세션 비용(또는 n/a for unknown/zero-priced model)
으로탈출 세션 시간

막대기는 단자 폭에 적응합니다 - 52-75의 소형 ≥ 76 란에 가득 차있는 배치, 최소한 (모델 + 내구 전용) 52.

** 텍스트 색상 코딩: 더 보기

색깔: 백색뚱 베어이름 *
(주)그린< 50%객실 시설
황색50–80%전체보기
담당자: Ms80–95%접근 제한
이름 *≥ 95%오버플로우에 - 고려 /compress

/usage 를 사용하여 per-category cost(input vs output token)을 포함한 상세 내역을 확인할 수 있습니다.

세션 이력서 표시

이전 세션 (hermes -c 또는 hermes --resume &lt;id&gt;)을 재개할 때, "이전 대화" 패널은 배너와 입력 프롬프트 사이에 나타나며 대화 기록의 컴팩트한 리캡을 보여줍니다. [Sessions - 이력서에 대화 재구성] (session.md#conversation-recap-on-resume) 세부 사항 및 구성.

키빈딩

이름 *(주)
Enter에 대해서자주 묻는 질문
Alt+Enter, Ctrl+J, 또는 Shift+Enter새로운 선 (다선 입력). Shift+EnterEnter에서 구별하는 터미널이 필요합니다. Windows 터미널에서 Alt+Enter는 터미널 (풀스크린 도글); 사용 Ctrl+Enter 또는 Ctrl+J 대신 캡처됩니다.
Alt+V에 대해서터미널에 의해 지원 될 때 클립보드에서 이미지를 붙여
Ctrl+V에 대해서Paste text and opportunistically 클립보드 이미지 첨부
Ctrl+B에 대해서음성 모드가 활성화될 때 시작/스톱 음성 녹음 (voice.record_key, 기본값: ctrl+b)
Ctrl+G에 대해서$EDITOR (vim/nvim/nano/VS Code/etc.)의 현재 입력 버퍼를 엽니다. 다음 프롬프트로 편집 된 텍스트를 보내려면 저장하고 종료합니다. - 긴, 멀티 퍼프 프롬프트에 이상적입니다.
Ctrl+X Ctrl+E에 대해서외부 편집기 (Ctrl+G)에 대한 Emacs 스타일 교체 바인딩.
Ctrl+C에 대해서Interrupt 대리인 (힘 출구에 2s 내의 두 배 압박)
Ctrl+D에 대해서오시는 길
Ctrl+Z에 대해서배경에 Hermes를 중단 (유닉스 전용). 실행 fg 쉘에서 다시 시작합니다.
Tab에 대해서auto-suggestion (ghost text) 또는 autocomplete slash 명령을 수락하십시오

** Multiline 풀 미리보기.** 멀티 라인 블록을 붙여 넣을 때 CLI는 스크롤백으로 전체 페이로드를 덤프 대신 ([pasted: 47 lines, 1,842 chars — press Enter to send])의 컴팩트 한 싱글 라인 미리보기 ([pasted: 47 lines, 1,842 chars — press Enter to send])를 설정합니다. 전체 콘텐츠는 여전히 전송되는 것입니다; 이것은 단지 디스플레이 광택입니다.

** 마지막 응답에 있는 Markdown 벗기는. ** CLI는 가장 동위 markdown 울타리와 **bold** / *italic* 래퍼를 final 에이전트에서 재생할 수 있는 터미널 프로버로 렌더링합니다. 코드 블록 및 목록은 보존됩니다. 이것은 게이트웨이 플랫폼이나 도구 결과에 영향을 미치지 않습니다. 그들은 기본 렌더링에 대한 마크 다운을 유지합니다.

Slash 명령

타입 / 자동 완성 드롭다운을 볼 수 있습니다. Hermes는 CLI slash 명령, 동적 기술 명령 및 사용자 정의 빠른 명령의 큰 세트를 지원합니다.

일반적인 예:

이름 *이름 *
/help에 대해서표시 명령 도움
/model에 대해서현재 모델 표시 또는 변경
/tools에 대해서현재 사용 가능한 도구
/skills browse에 대해서기술 허브 및 공식 선택 기술 검색
/background &lt;prompt&gt;에 대해서별도의 배경 세션에서 신속한 실행
/skin에 대해서활성 CLI 스킨을 표시하거나 전환
/voice on에 대해서Enable CLI 음성 모드 (press Ctrl+B 레코드)
/voice tts에 대해서Hermes replies에 대한 이야기
/reasoning high에 대해서객관적인 노력
/title My Session에 대해서현재 세션

전체 내장 CLI 및 메시징 목록을 보려면 Slash Commands Reference를 참조하십시오.

설정, 공급자, 침묵 조정 및 메시징/Discord 음성 사용, Voice Mode를 참조하십시오.

명령은 case-insensitive — /HELP와 동일하게 동작한다 /help. 설치된 기술도 슬래시 명령이 자동으로됩니다.

빠른 명령

LLM을 호출하지 않고 즉시 쉘 명령을 실행할 수 있습니다. CLI 및 메시징 플랫폼 모두에서 이러한 작업 (Telegram, Discord 등).

# ~/.hermes/config.yaml
quick_commands:
status:
type: exec
command: systemctl status hermes-agent
gpu:
type: exec
command: nvidia-smi --query-gpu=utilization.gpu,memory.used --format=csv,noheader
restart:
type: alias
target: /gateway restart

다음 유형 /status, /gpu, 또는 /restart 어떤 채팅에서. Configuration guide를 참조해 주세요.

출시에 대한 기술

세션에 능동적으로 원하는 기술을 이미 알고 있다면, 시작 시간에 전달하십시오

hermes -s hermes-agent-dev,github-auth
hermes chat -s github-pr-workflow -s github-auth

Hermes는 각 이름의 기술이 첫 번째 회전 전에 세션 프롬프트로로드합니다. 동일한 깃발은 상호 작용하는 형태와 단 하나 정복 형태에서 작동합니다.

기술 슬래시 명령

~/.hermes/skills/의 모든 설치된 기술은 슬래시 명령으로 자동으로 등록됩니다. 기술 이름은 명령이 된다:

/gif-search funny cats
/axolotl help me fine-tune Llama 3 on my dataset
/github-pr-workflow create a PR for the auth refactor

# Just the skill name loads it and lets the agent ask what you need:
/excalidraw

이름 *

에이전트의 톤을 변경하는 사전 정의 된 성격을 설정:

/personality pirate
/personality kawaii
/personality concise

내장된 개성은 다음과 같습니다: helpful, concise, technical, creative, teacher, kawaii, catgirl, pirate, ..., ....

~/.hermes/config.yaml의 맞춤 개인성을 정의할 수 있습니다

personalities:
helpful: "You are a helpful, friendly AI assistant."
kawaii: "You are a kawaii assistant! Use cute expressions..."
pirate: "Arrr! Ye be talkin' to Captain Hermes..."
# Add your own!

Multi-line 입력

멀티 라인 메시지를 입력하는 두 가지 방법이 있습니다:

  1. Alt+Enter, Ctrl+J, 또는 Shift+Enter - 새 줄을 삽입
  2. Backslash continuation - 계속하려면 \로 선을 종료하십시오
❯ Write a function that:\
1. Takes a list of numbers\
2. Returns the sum
정보

멀티 라인 텍스트를 붙여 넣기 - 위의 새로운 라인 키의 사용, 또는 단순히 콘텐츠를 직접 붙여 넣기.

Shift+Enter 호환성

대부분의 터미널은 EnterShift+Enter에 대한 동일한 바이트 스탬프를 전송하므로 응용 프로그램을 구별 할 수 없습니다. 헤르메스가 Shift+Enter를 인식합니다. 단말이 Kitty keyboard Protocol 또는 xterm's modifyOtherKeys 모드를 통해 구별되는 시퀀스를 전송합니다.

기타주요연혁
키티, 발, WezTerm, GhosttyDistinct Shift+Enter 기본 설정
iTerm2 (반도), 아크릴, VS 코드 터미널, WarpKitty 프로토콜이 설정에서 지원됩니다
윈도우 터미널 미리보기 1.25+Kitty 프로토콜이 설정에서 지원됩니다
macOS Terminal.app, Windows 터미널(테이블)지원되지 않음 - Shift+EnterEnter에서 무효

터미널이 구분할 수 없는 경우, Alt+EnterCtrl+J는 모든 곳에서 계속 작동합니다. **특히 Windows 터미널에서, Alt+Enter는 터미널 (투글 풀스크린)에 의해 캡처되며 Hermes에 도달하지 않습니다. 사용 Ctrl+Enter (Ctrl+J로 배달) 또는 Ctrl+J를 직접 새로운 라인으로 사용합니다. 더 보기

에이전트 연동

당신은 어떤 점에서 대리인을 중단할 수 있습니다:

  • ** 새로운 메시지를 입력 + Enter** 에이전트가 작동 중 - 그것은 중단하고 새로운 지침을 처리
  • Ctrl+C - 현재 동작을 중단합니다. (2s에서 강제 종료)
  • In-progress 터미널 명령은 즉시 사망합니다 (SIGTERM, 그 후 SIGKILL 1s 후)
  • 중단 도중 유형의 다수 메시지는 1개의 신속한으로 결합됩니다

Busy 입력 모드

display.busy_input_mode config 키 컨트롤 에이전트가 작동 중에 Enter를 누르면 무슨 일이 일어나는지:

주요 특징채용 정보
"interrupt" (기본값)귀하의 메시지는 현재 작동을 중단하고 즉시 처리됩니다
"queue"에 대해서귀하의 메시지는 침묵 하 고 에이전트 마무리 후 다음 차례로 보내
"steer"에 대해서이 메시지를 나눔으로써 /steer, arriving at the Agent after the next tool call — no interrupt, no new turn 서포트 해 주세요
# ~/.hermes/config.yaml
display:
busy_input_mode: "steer" # or "queue" or "interrupt" (default)
``"queue"` 모드는 실수로 취소하지 않고 후속 메시지를 준비 할 때 유용합니다. `"steer"` 모드는 중단없이 에이전트 중첩을 리디렉션 할 때 유용합니다. 예. "실제로, 또한 테스트를 확인합니다"는 여전히 편집 코드입니다. 잘 알려진 값은 `"interrupt"`로 돌아갑니다.

`"steer"`는 두 개의 자동 낙하가 있습니다. 에이전트가 아직 시작되지 않았거나 이미지가 첨부되면 메시지가 `"queue"` 동작으로 돌아갑니다.

CLI 안에서도 변경할 수 있습니다:

```text
/busy queue
/busy steer
/busy interrupt
/busy status
First-touch hint

Hermes가 일하고 있는 동안 Enter를 누르는 매우 처음에는 Hermes가 /busy knob ("(tip) Your message interrupted the current run…")를 설명하는 원라인 알림을 인쇄합니다. 설치 당 한 번만 화재 - config.yaml의 플래그가 onboarding.seen.busy_input_prompt의 밑에 있습니다. 팁을 다시 볼 수있는 열쇠를 삭제합니다.

배경에 따라

유닉스 시스템에서 프레스 **Ctrl+Z**는 어떤 터미널 프로세스와 같은 배경으로 헤르메스를 중단합니다. 포탄은 확인을 인쇄합니다:

Hermes Agent has been suspended. Run `fg` to bring Hermes Agent back.

쉘에서 fg를 입력하여 세션을 정확히 파악합니다. 이것은 Windows에서 지원되지 않습니다.

Tool 진행 표시

CLI는 에이전트 작업으로 애니메이션 피드백을 보여줍니다:

Thinking Animation (API 호출 중):

  ◜ (。•́︿•̀。) pondering... (1.2s)
◠ (⊙_⊙) contemplating... (2.4s)
✧٩(ˊᗜˋ*)و✧ got it! (3.1s)

Tool 실행 피드:

  ┊ 💻 terminal `ls -la` (0.3s)
┊ 🔍 web_search (1.2s)
┊ 📄 web_extract (2.1s)
``/verbose`: `off → new → all → verbose`와 디스플레이 모드를 통해 사이클. 이 명령은 메시징 플랫폼에서도 사용할 수 있습니다. [configuration](/docs/user-guide/configuration#quick-commands)를 참조하십시오.

### 공구 미리보기 길이 \{#suspending-to-background}

`display.tool_preview_length` 구성 키는 도구 호출 미리보기 라인 (예: 파일 경로, 터미널 명령)에서 보이는 문자의 최대 숫자를 제어합니다. 기본값은 `0`이며, 제한이 없습니다. - 전체 경로와 명령은 표시됩니다.

```yaml
# ~/.hermes/config.yaml
display:
tool_preview_length: 80 # Truncate tool previews to 80 chars (0 = no limit)

이것은 좁은 맨끝에 유용합니다 또는 공구 인수가 아주 긴 파일 경로를 포함할 때.

세션 관리

Resuming 세션

CLI 세션을 종료하면 이력서 명령이 인쇄됩니다

Resume this session with:
hermes --resume 20260225_143052_a1b2c3

Session: 20260225_143052_a1b2c3
Duration: 12m 34s
Messages: 28 (5 user, 18 tool calls)

공급 능력:

hermes --continue                          # Resume the most recent CLI session
hermes -c # Short form
hermes -c "my project" # Resume a named session (latest in lineage)
hermes --resume 20260225_143052_a1b2c3 # Resume a specific session by ID
hermes --resume "refactoring auth" # Resume by title
hermes -r 20260225_143052_a1b2c3 # Short form

Resuming은 SQLite의 전체 대화 기록을 복원합니다. 에이전트는 이전 메시지, 도구 호출 및 응답을 볼 수 있습니다. - 그냥 당신이 결코 왼쪽으로.

/title My Session Name 를 호출하여 현재 세션 이름을 지정하거나, 명령줄에서 hermes sessions rename &lt;id&gt; &lt;title&gt; 를 사용합니다. hermes sessions list를 사용하여 과거 세션을 검색합니다.

세션 저장

CLI 세션은 Hermes의 SQLite 상태 데이터베이스에 ~/.hermes/state.db에 저장됩니다. 데이터베이스 유지:

  • 세션 메타데이터 (ID, 제목, 타임스탬프, 토큰 카운터)
  • 메시지 역사
  • 압축/반응된 세션을 통한 선량
  • 전체 텍스트 검색 인덱스 session_search

일부 메시징 어댑터는 데이터베이스와 함께 per-platform transcript 파일을 유지하지만 CLI 자체는 SQLite 세션 저장소에서 다시 시작합니다.

Context 압축

긴 대화는 문맥 제한에 접근 할 때 자동으로 요약됩니다

# In ~/.hermes/config.yaml
compression:
enabled: true
threshold: 0.50 # Compress at 50% of context limit by default

# Summarization model configured under auxiliary:
auxiliary:
compression:
model: "" # Leave empty to use the main chat model (default). Or pin a cheap fast model, e.g. "google/gemini-3-flash-preview".

압축 방아쇠가 될 때, 중간 회전은 첫 번째 3 및 마지막 20 회전이 항상 보존 된 동안 요약됩니다.

배경 세션

다른 작업에 대한 CLI를 사용하려면 별도의 배경 세션에서 프롬프트를 실행하십시오

/background Analyze the logs in /var/log and summarize any errors from today

Hermes는 즉시 작업을 확인하고 신속하게 다시 제공합니다

🔄 Background task #1 started: "Analyze the logs in /var/log and summarize..."
Task ID: bg_143022_a1b2c3

어떻게 작동하나요

/background 프롬프트는 ** 완전하게 별도의 에이전트 세션 ** 데몬 스레드에서:

  • **Isolated 대화 ** - 배경 에이전트는 현재 세션의 역사에 대한 지식이 없습니다. 그것은 당신이 제공 한 신속한 만받습니다.
  • Same Configuration — 배경 에이전트는 현재 세션에서 모델, 공급자, 툴렛, 소싱 설정 및 fallback 모델을 상속합니다.
  • Non-blocking — 당신의 전경 세션은 완전히 상호 작용합니다. 채팅, 실행 명령, 또는 더 많은 배경 작업을 시작할 수 있습니다.
  • Multiple task - 동시에 여러 배경 작업을 실행할 수 있습니다. 각 번호 ID를 가져옵니다.

이름 *

배경 작업이 완료되면, 결과는 터미널의 패널로 나타납니다

╭─ ⚕ Hermes (background #1) ──────────────────────────────────╮
│ Found 3 errors in syslog from today: │
│ 1. OOM killer invoked at 03:22 — killed process nginx │
│ 2. Disk I/O error on /dev/sda1 at 07:15 │
│ 3. Failed SSH login attempts from 192.168.1.50 at 14:30 │
╰──────────────────────────────────────────────────────────────╯

작업이 실패하면 오류 알림이 표시됩니다. display.bell_on_complete가 설정된 경우, 작업이 완료되면 터미널 벨링이 됩니다.

사용 사례

  • **Long-running 연구 ** - "/background는 코드에서 작동하는 동안 quantum 오류 보정의 최신 개발을 연구"
  • File processing — "/background는 이 재포에서 모든 파이썬 파일을 분석하고 대화를 계속하면서 보안 문제를 나열합니다"
  • **Parallel 조사 ** - 동시에 다른 각도를 탐구하기 위해 여러 배경 작업을 시작합니다
정보

배경 세션은 주요 대화 기록에 나타나지 않습니다. 그들은 자신의 작업 ID (예를 들어, bg_143022_a1b2c3)와 독립 세션입니다.

Quiet 형태

기본적으로 CLI는 조용한 모드에서 실행합니다

  • Suppresses verbose 로깅 도구
  • Enables kawaii-style 애니메이션 피드백
  • 출력을 깨끗하고 사용자 친화적 유지

debug 산출을 위해:

hermes chat --verbose