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를 사용하세요. Android는 Termux를 통해 설치하며, 이는 업스트림 문서의 전용 경로를 따릅니다.

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

이러한 플래그는 하위 명령어 전에 적용되며, 어떤 프로필, 어떤 세션, 또는 얼마만큼의 개인 설정을 로드할지를 변경합니다.

플래그 설명
--profile, -p 이번 실행을 위한 Hermes 프로필 선택 (hermes profile use의 스티키 기본값을 덮어씁니다).
--resume, -r ID 또는 제목으로 세션 재개.
--continue [name], -c 최신 세션 또는 제목과 일치하는 최신 세션 계속하기.
--worktree, -w 병렬 에이전트를 위한 격리된 Git 워크트리에서 시작.
--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**와 결합하여 재현 가능한 원샷(one-shot) 작업을 수행합니다.

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

명령어 / 패턴 설명
hermes chat 대화형 또는 스크립트 기반 채팅; -q, -m, --provider, 툴셋, 재개, 워크트리, 체크포인트를 위한 주요 인터페이스.
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 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 호스팅(레이턴시, 비용, 운영)의 트레이드오프와 동일합니다.

기본값이 Ollama 등에서의 Qwen 또는 Gemma로 설정되면, 입력한 모델 ID만큼이나 샘플러 기본값이 중요합니다. 에이전트 중심의 온도 및 페널티 프리셋은 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 프로필 타볼(tarball) 아카이빙 또는 복원.
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 등을 참조하세요.

명령어 설명
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 헤드리스 서버 및 원격 데스크톱 설정을 따르세요.

크론 스케줄러, 웹훅 및 칸반

명령어 설명
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**가 가장 빠른 triage 루프를 형성합니다.

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 … 병렬 백그라운드 실행, 큐에 대기 중인 다음 프롬프트, 다음 도구 후의 미드루프 유도.
/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 엔지니어링에 관한 새 글을 받아보세요.