허메스 에이전트 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를 사용하세요. Android 설치는 Termux를 통해 진행되며, 상류 문서에 별도의 경로가 있습니다.

모든 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와 함께 사용하여 TUI 개발을 위해 tsx를 통해 TS 소스 실행.

고립된 자동화는 종종 재현 가능한 원샷을 위해 **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 실행별 모델 및 제공업체 덮어쓰기; env HERMES_INFERENCE_MODEL / HERMES_INFERENCE_PROVIDER가 동작을 거울링.
-t / --toolsets 실행을 위해 쉼표로 구분된 도구 세트 활성화.
-s / --skills 스킬 사전 로드 (반복 또는 쉼표로 구분).
--image path 단일 쿼리에 로컬 이미지 첨부.
--checkpoints 파괴적 편집 전 파일시스템 체크포인트 활성화.
--max-turns N 턴당 도구 호출 반복 횟수 제한 (설정에서 기본값).
--source 세션 소스 태그 (통합을 위한 cli vs tool).

세션 외부의 Hermes 모델 vs 내부의 /model — 셸에서 **hermes model**을 실행하는 것은 제공업체, 키, OAuth를 추가하는 곳입니다. 슬래시 **/model**은 이미 구성된 제공업체 사이에서만 전환합니다. /model에서 OpenRouter만 보인다면, 세션을 종료하고 **hermes model**을 완료하세요.

모델 선택기, 자격 증명 풀 및 대체 제공업체

명령어 설명
hermes model 대화형 제공업체 및 모델 선택기; 키, OAuth, 사용자 정의 엔드포인트.
hermes auth 자격 증명 풀 — add, list, remove, reset을 통한 회전 친화적 키 및 OAuth.
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 호스팅 (지연 시간, 비용, 운영)과 동일한 트레이드오프에 기반합니다.

설정 파일 및 hermes config 명령어

설정은 CLI 덮어쓰기 → config.yaml → .env → 기본값 순으로 해결됩니다. API 키는 **.env**에, 구조화된 설정은 **config.yaml**에 belongs 합니다.

명령어 설명
hermes config show 유효한 설정 표시.
hermes config edit $EDITOR에서 config.yaml 열기.
hermes config set key value 값 설정 (비밀은 .env로, 비비밀은 YAML로 라우팅).
hermes config path / hermes config env-path 설정 및 env 파일 경로 출력.
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 어시스턴트 스킬 — 실제 프로덕션 설정](https://www.glukhov.org/ko/ai-systems/hermes/production-setup/ “엔지니어, 연구원, 운영자 및 경영진 워크플로우를 위한 프로덕션 환경의 Hermes Agent 설정 및 스킬을 위한 프로필 기반 가이드.“을 참조하세요.

명령어 설명
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**을 실행하는 것이 견고한 패턴입니다.

Cron 스케줄러, 웹훅 및 칸반

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

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 에디터를 위한 에이전트 클라이언트 프로토콜 stdio 서버 (추가 설치 필요할 수 있음).
hermes dashboard [--port …] [--host …] 로컬 웹 대시보드 (pip install hermes-agent[web]).
hermes claw migrate … OpenClaw 스타일 설정을 Hermes로 마이그레이션 (--dry-run, 프리셋, 선택적 비밀).

OpenClaw 마이그레이션 — hermes claw migrate는 레거시 OpenClaw 홈 디렉토리를 읽습니다; 이전 스택의 모습을 보려면 OpenClaw 사례 연구을 참조하세요.

Hermes CLI 세션의 슬래시 명령어

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

세션 흐름, 백그라운드 작업 및 목표

명령어 설명
/new, /reset 새 세션 ID 및 기록.
/resume [name] 지정된 세션 재개.
/compress [focus] 선택적 초점 주제와 함께 수동 컨텍스트 압축.
/retry, /undo 마지막 턴 재시도 또는 마지막 대화 삭제.
/title … 나중에 /resume을 위해 세션 이름 지정.
/background …, /queue …, /steer … 병렬 백그라운드 실행, 대기 중인 다음 프롬프트, 다음 도구 후 중간 루프 나udge.
/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 엔지니어링에 관한 새 글을 받아보세요.