Hermes Agent CLI 치트시트 — 명령어, 플래그 및 슬래시 단축키

셀프 호스팅된 Hermes 에이전트를 위한 셸 및 TUI 명령어

Page content

Nous Research의 Hermes Agent는 모델에 구애받지 않고, 도구를 활용하는 로컬 또는 VPS에서 실행할 수 있는 어시스턴트입니다.

Hermes는 특정 인터페이스로 사용자를 묶어 두지 않습니다. 다음 방법들을 사용할 수 있습니다.

  • 클래식 hermes / hermes chat CLI,
  • 전체 화면 hermes --tui 세션,
  • Telegram, Discord, Slack 및 기타 메시징 플랫폼용 장기 실행 hermes gateway,
  • 웹 추가 기능이 설치된 경우 로컬 브라우저 UI를 위한 hermes dashboard.

이러한 경로들은 ~/.hermes 아래에서 동일한 설정과 데이터를 공유합니다. 이 페이지에서는 이러한 모드에서 중요한 셸 명령어들을 나열합니다.

Hermes Agent CLI 치트시트 — 터미널 참조

아래는 작업별로 그룹화된 밀집된 명령어 참조 자료입니다.

Hermes Agent 설치 및 첫 실행 CLI 명령어

설치 및 문제 해결에 대해서는 Hermes AI 어시스턴트 — 설치, 설정, 워크플로 및 문제 해결부터 시작하세요.

인스톨러는 저장소를 가져오고, Python 환경을 설정하며, hermes 실행 파일을 연결합니다. source ~/.bashrc 또는 ~/.zshrc를 실행한 후, 대화형 채팅을 위한 기본 진입점은 단순히 **hermes입니다 (hermes chat**과 동일한 계열).

명령어 설명
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash 공식 원라인 설치 (Linux, macOS, WSL2).
hermes / hermes chat 설치 후 대화형 채팅 시작 (기본 일상용 진입점).
hermes --version / hermes version 버전 정보 출력.
hermes completion bash | zsh | fish 탭 완성을 위한 셸 완성 스크립트 출력.
hermes update [--check] [--backup] [--restart-gateway] 최신 코드 가져오기, 의존성 재설치, 선택적 업데이트 전 홈 스냅샷 또는 게이트웨이 재시작.
hermes uninstall [--full] [--yes] Hermes 제거. 선택적 전체 데이터 삭제.

네이티브 Windows는 지원하지 않으며, WSL2를 사용해야 합니다. Termux를 통한 Android 설치 절차는 업스트림 문서에서 별도의 경로를 따릅니다.

모든 hermes 호출에 적용되는 전역 플래그

이 플래그들은 서브커맨드 전에 적용되며, 어떤 프로필, 어떤 세션을 사용할지 또는 얼마나 많은 개인 설정을 로드할지를 변경합니다.

플래그 설명
--profile, -p 이번 실행을 위한 Hermes 프로필 선택 (hermes profile use의 고정된 기본값을 무시).
--resume, -r ID 또는 제목으로 세션 재개.
--continue [name], -c 최신 세션 또는 제목이 일치하는 최신 세션 계속.
--worktree, -w 병렬 에이전트를 위한 격리된 Git worktree에서 시작.
--yolo 위험한 명령어 승인 프롬프트 우회 (신중히 사용).
--pass-session-id 시스템 프롬프트에 세션 ID 포함.
--ignore-user-config ~/.hermes/config.yaml 스킵 (기본값만 사용). .env는 여전히 로드됩니다.
--ignore-rules AGENTS.md, SOUL.md, .cursorrules, 메모리, 사전 로드된 스킬의 자동 주입 스킵.
--tui TUI 실행 (HERMES_TUI=1과 동일).
--dev --tui와 함께使用时, tsx를 통해 TS 소스를 실행하여 TUI 개발.

격리된 자동화 작업에서는 재현 가능한 원샷 실행을 위해 **hermes chat --ignore-user-config --ignore-rules**와 **hermes -z**를 함께 사용하는 경우가 많습니다.

hermes chat, 원샷 프롬프트 및 hermes -z

명령어 / 패턴 설명
hermes chat 대화형 또는 스크립트 기반 채팅. -q, -m, --provider, 도구셋, 재개, worktree, 체크포인트의 주요 인터페이스.
hermes chat -q "..." 원샷 프롬프트 (비대화형). 도구가 실행될 때 -z보다 풍부한 출력을 유지.
hermes -z "..." 스크립트 기반 원샷 — stdout에 최종 답변만 출력, 배너나 세션 노이즈 없음. 동일한 에이전트와 도구. 파이프와 스크립트에 최적.
hermes chat --quiet, -Q 조용한 프로그래밍 모드 (배너 및 도구 미리보기 억제).
-m / --model, --provider 실행별 모델 및 프로바이더 오버라이드. 환경 변수 HERMES_INFERENCE_MODEL / HERMES_INFERENCE_PROVIDER가 동일한 동작을 반영.
-t / --toolsets 실행을 위한 콤마로 구분된 도구셋 활성화.
-s / --skills 스킬 사전 로드 (반복 사용 또는 콤마로 구분).
--image path 단일 쿼리에 로컬 이미지 첨부.
--checkpoints 파괴적 편집 전 파일시스템 체크포인트 활성화.
--max-turns N 턴별 도구 호출 반복 횟수 상한 설정 (기본값은 설정에서 가져옴).
--source 세션 소스 태그 (통합을 위해 cli 또는 tool).

세션 외부의 Hermes 모델 vs 세션 내부의 /model — 셸에서 **hermes model**을 실행하는 것은 프로바이더, 키, OAuth를 추가하는 곳입니다. 슬래시 **/model**은 이미 설정된 프로바이더 사이에서만 전환합니다. /model에서 OpenRouter만 보인다면, 세션을 종료하고 **hermes model**을 완료하십시오.

모델 선택기, 자격 증명 풀 및 폴백 프로바이더

명령어 설명
hermes model 대화형 프로바이더 및 모델 선택기. 키, OAuth, 커스텀 엔드포인트.
hermes auth 자격 증명 풀 — 로테이션에 적합한 키와 OAuth를 위한 add, list, remove, reset.
hermes fallback [list | add | remove | clear] 주요 프로바이더가 오류나 레이트 리밋을 만날 때 순서가 정해진 폴백 프로바이더 관리.
hermes setup [model | tts | terminal | gateway | tools | agent] [...] 섹션별 또는 전체 대화형 설정 (--quick, --reset, --non-interactive).

비추천되는 hermes login / hermes logout — 대신 **hermes auth**와 **hermes model**을 사용하십시오.

**hermes model**에서 로컬 OpenAI 호환 엔드포인트와 호스티드 API를 선택하는 것은 일반적인 LLM 호스팅(레이턴시, 비용, 운영)과 동일한 트레이드오프를 가지고 있습니다.

기본 모델이 Ollama와 같은 환경에서 Qwen 또는 Gemma로 설정되면, 어떤 모델 ID를 입력했는가에 못지 않게 샘플러 기본값도 중요합니다. 에이전트 지향적인 temperature와 페널티 프리셋은 Qwen과 Gemma를 위한 에이전틱 LLM 추론 파라미터에서 종합적으로 볼 수 있습니다.

설정 파일 및 hermes config 명령어

설정은 CLI 오버라이드 → config.yaml → .env → 기본값 순서로 해결됩니다. API 키는 **.env**에, 구조화된 설정은 **config.yaml**에 속합니다.

명령어 설명
hermes config show 유효한 설정 표시.
hermes config edit $EDITOR에서 config.yaml 열기.
hermes config set key value 값 설정 (비밀번호는 .env로, 비비밀 정보는 YAML로 라우팅).
hermes config path / hermes config env-path 설정 및 환경 파일 경로 출력.
hermes config check 누락되었거나 오래된 설정 감지.
hermes config migrate 새로 도입된 옵션을 대화형으로 적용.

파일 위치 — 설정, 비밀 정보, 메모리, 스킬, 세션, 게이트웨이 상태 및 로그는 모두 HERMES_HOME(기본값 ~/.hermes) 아래에 위치합니다.

세션 관리 및 hermes profile

명령어 설명
hermes sessions list 최근 세션 목록.
hermes sessions browse 검색 및 재개가 포함된 대화형 선택기.
hermes sessions export 세션 내보내기 (예: JSONL).
hermes sessions delete, prune, rename, stats 세션 하나 삭제, 오래된 세션 정리, 제목 이름 변경, 저장소 통계 표시.
hermes profile list | use | create | delete | show | rename 한 대의 머신에서 격리된 Hermes 인스턴스 관리.
hermes profile export / import 프로필 타르볼 아카이브 또는 복원.
hermes profile alias 빠른 프로필 전환을 위한 짧은 래퍼 스크립트.

고정된 기본 프로필을 변경하지 않고 임시로 실행하려면 **hermes -p work chat -q "..."**를 사용하십시오.

스킬 허브, 도구셋, 셸 훅 및 플러그인

역할에 맞춰 실제 프로덕션 워크플로를 위한 프로파일 우선 설정 및 스킬에 대해서는 실제 프로덕션 설정을 위한 Hermes AI 어시스턴트 스킬를 참조하세요. SKILL.md 파일 작성 및 디버깅(메타데이터, 점진적 공개, 조건부 가시성)에 대해서는 Hermes Agent 스킬 저작 — SKILL.md 구조 및 모범 사례를 참조하세요.

명령어 설명
hermes tools 플랫폼별 대화형 도구 활성화. --summary로 현재 선택 사항 출력.
hermes skills browse, search, inspect, install, list, check, update, audit, uninstall, publish, snapshot, tap, config 레지스트리 및 URL 설치를 포함한 스킬 허브 워크플로.
hermes curator status, run, pause, pin, rollback, … 백그라운드 스킬 유지보수 및 안전한 롤백.
hermes hooks list, test, revoke, doctor 설정에 선언된 셸 훅 및 허용 목록.
hermes plugins 플러그인 설치, 활성화, 비활성화, 제거를 위한 복합 UI 또는 서브커맨드.

내장 메모리 및 hermes memory 프로바이더

내장 MEMORY.md / USER.md는 활성화 상태로 유지되며, 외부 프로바이더는 선택적 기억 계층을 추가합니다. 해당 아키텍처가 실제로 어떻게 작동하는지 이해하려면 Hermes Agent 메모리 시스템 — 영구 AI 메모리의 실제 작동 방식를 읽어보십시오. 외부 백엔드와 활성화 트레이드오프를 비교하려면 에이전트 메모리 프로바이더 비교 — Honcho, Mem0, Hindsight 외 5종를 참조하세요.

명령어 설명
hermes memory setup 대화형 외부 메모리 프로바이더 설정.
hermes memory status 활성화된 프로바이더 설정 표시.
hermes memory off 외부 프로바이더 비활성화. 내장 파일은 유지됨.

프로바이더가 활성화되면 프로바이더별 추가 최상위 서브커맨드를 등록할 수 있습니다 — 현재 연결된 것을 보려면 **hermes --help**를 실행하십시오.

메시징 게이트웨이, DM 페어링 및 플랫폼

명령어 설명
hermes gateway setup 대화형 메시징 플랫폼 설정.
hermes gateway run 포그라운드 게이트웨이 (WSL, Docker, Termux에서 권장).
hermes gateway start | stop | restart | status systemd / launchd 서비스 제어 (--all은 모든 프로필의 게이트웨이에 영향).
hermes gateway install | uninstall 사용자 레벨 백그라운드 서비스 설치 또는 제거.
hermes pairing list | approve | revoke | clear-pending 메시징 봇을 위한 DM 페어링 승인.
hermes whatsapp WhatsApp 브릿지 페어링 플로우.
hermes slack manifest 게이트웨이 슬래시 패리티를 포함한 Slack 앱 매니페스트 생성.

WSL에서는 **gateway start**가 제대로 작동하지 않을 때 tmux 안에서 **hermes gateway run**을 실행하는 것이 견고한 패턴입니다. 동일한 게이트웨이 계층을 사용하여 전화기로 종단간 워크플로를 구성하는 것에 대해서는 전화기에서 Hermes 음성 제어를 참조하세요. 별도 데스크톱 클라이언트를 사용하는 전용 서버 운영에 대해서는 Hermes Agent 헤드리스 서버 및 리모트 데스크톱 설정를 따르세요.

Cron 스케줄러, 웹훅 및 칸반

명령어 설명
hermes cron … 예약된 프롬프트 생성, 편집, 일시정지, 재개, 실행, 제거 (tick은 수동 스케줄러 패스).
hermes webhook subscribe, list, remove, test 이벤트 구동 실행을 위한 동적 웹훅 라우트.
hermes kanban … SQLite 기반 다중 프로필 태스크 보드. dispatch는 워커를 구동.

셀프호스팅된 게이트웨이에서 hermes kanban을 위한 실용적인 동시성 패턴이 필요하면 셀프호스팅 LLM 워크플로를 위한 Hermes Agent 칸반를 참조하세요.

hermes doctor, 로그, 백업 및 사용량 인사이트

명령어 설명
hermes doctor [--fix] 대화형 진단 및 선택적 자동 수리.
hermes status [--all] [--deep] 간결한 상태 표시. 필요시 더 깊은 검사.
hermes dump [--show-keys] Discord 또는 GitHub 이슈를 위한 붙여넣기 친화적 설정 요약.
hermes debug share 수정된 디버그 번들을 페스트 서비스에 업로드 (또는 --local).
hermes logs [agent | errors | gateway | list] 프로필 로그 디렉터리에서 로그 꼬리 보기 및 필터링.
hermes backup, hermes import 홈 데이터 ZIP 스냅샷 및 복원 경로.
hermes insights [--days N] [--source …] 토큰, 비용 및 활동 분석.

업데이트 후 무언가가 깨졌을 때, hermes doctor, hermes status, 그리고 **hermes logs errors -f**가 가장 빠른 트리아지 루프를 형성합니다.

MCP, ACP, 웹 대시보드 및 OpenClaw 마이그레이션

명령어 설명
hermes mcp serve Hermes를 MCP 서버로 실행.
hermes mcp add, remove, list, test, configure Hermes에서 MCP 클라이언트 연결 관리.
hermes acp 에디터를 위한 Agent Client Protocol stdio 서버 (추가 설치 필요할 수 있음).
hermes dashboard [--port …] [--host …] 로컬 웹 대시보드 (pip install hermes-agent[web]).
hermes claw migrate … OpenClaw 스타일 설정을 Hermes로 마이그레이션 (--dry-run, 프리셋, 선택적 비밀 정보).

OpenClaw 마이그레이션 — hermes claw migrate는 레거시 OpenClaw 홈 디렉터리를 읽습니다. 드라이-런 리뷰, 충돌 정책, 비밀 정보 처리, 채널 인계 및 단계별 전환 전체는 OpenClaw에서 Hermes Agent로 안전하게 마이그레이션하는 방법에서 다룹니다. 이전 스택이 어떻게 생겼는지 보려면 OpenClaw 사례 연구를 참조하세요.

Hermes CLI 세션에서 사용할 수 있는 슬래시 명령어

자동완성을 위해 **/**를 입력하세요. 명령어는 대소문자를 구분하지 않습니다. 스킬은 추가 /skill-name 라우트를 등록합니다. 아래 표들은 큐레이션된 부분이며, 전체 레지스트리는 이 기사 하단의 공식 Hermes Agent 문서를 참조하세요.

세션 플로우, 백그라운드 태스크 및 목표

명령어 설명
/new, /reset 새 세션 ID 및 히스토리.
/resume [name] 지정된 세션 재개.
/compress [focus] 선택적 포커스 토픽을 포함한 수동 컨텍스트 압축.
/retry, /undo 마지막 턴 재시도 또는 마지막 교환 삭제.
/title … 나중 /resume을 위해 세션 이름 지정.
/background …, /queue …, /steer … 병렬 백그라운드 실행, 다음 프롬프트 대기열, 다음 도구 후 루프 중간 조정.
/goal … 판정 루프(status, pause, resume, clear)가 있는 영구 멀티턴 목표.
/branch, /fork 대안 탐색을 위해 대화 분기.

모델, 도구 토글, 스킬 및 재로드

명령어 설명
/model … [--global] 설정된 프로바이더 사이에서 모델 전환. --global은 기본값을 영구화.
/tools …, /toolsets 세션 도구 토글 및 도구셋 목록.
/skills … 채팅에서 스킬 검색, 설치 및 관리.
/cron … CLI 세션에서 예약된 태스크 UI.
/reload-mcp 설정에서 MCP 서버 재로드.
/reload 재시작 없이 실행 중인 세션에 .env 재로드.

사용량, 도움말 및 종료

명령어 설명
/usage, /insights 토큰 및 비용 가시성. 분석 스냅샷.
/help, /quit 도움말 또는 CLI 종료.

메시징 앱(Telegram, Discord, Slack 및 기타)은 겹치는 슬래시 명령어 세트 외에도 /approve, /restart, /commands 및 관련 게이트웨이 전용 헬퍼를 노출합니다 — 플랫폼 차이는 아래 공식 Hermes Agent 문서의 슬래시 명령어 참조에서 문서화되어 있습니다.

더 유용한 읽을거리

이 사이트의 관련 페이지 (Hermes 및 터미널 에이전트에 대한 더 넓은 맥락):

공식 Hermes Agent 문서

hermes-agent.nousresearch.com의 업스트림 문서:

팁. **hermes dump**와 **hermes doctor --fix**를 근육 기억에 새겨 두세요 — 그들은 모호한 “무언가가 깨졌다"는 보고를 알려진 정상 설정에 대한 실행 가능한 차이로 전환합니다.

구독하기

시스템, 인프라, AI 엔지니어링에 관한 새 글을 받아보세요.