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

자체 호스팅 Hermes Agent를 위한 셸 및 TUI 명령

Page content

Nous Research의 Hermes Agent는 모델에 구애받지 않고, 도구를 사용하는 어시스턴트로, 로컬 또는 VPS에서 셸, 전체 화면 TUI, 또는 메시징 게이트웨이를 통해 실행할 수 있습니다.

Hermes는 사용자를 하나의 인터페이스에 묶어 두지 않습니다. 사용자는 다음 방법을 활용할 수 있습니다.

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

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

Hermes Agent CLI cheat sheet — terminal reference

아래는 2026년 10월 6일 공식 CLI 명령어 참조 자료를 기반으로 확인된, 작업별로 그룹화된 조밀한 명령어 참조입니다. 해당 시점의 최신 안정 태그는 v0.21.5(v2026.9.24)입니다.

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 개발을 위해 TS 소스를 tsx로 실행.

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

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

명령어 / 패턴 설명
hermes chat 대화형 또는 스크립트 채팅; -q, -m, --provider, 도구 세트, 재개, 워크트리, 체크포인트의 주요 표면.
hermes chat -q "..." TTY에서 프롬프트를 첫 번째 턴으로 제출하고 세션에 잔류. 0.21 이전에는 한 답변 후 종료되었습니다.
hermes chat --oneshot -q "..." 답변 후 종료 (기존 -q 동작). -Q 또는 비-TTY stdio에 의해 묵시적으로 적용됩니다. 트랜스크립트에 도구 출력이 필요할 때 사용.
hermes chat --query-file PATH 파일에서 프롬프트 읽기, 또는 stdin을 위한 -. 셸 해석되지 않음. -q와 상호 배타적.
hermes -z "..." 스크립트 원샷 — stdout에 최종 답변만 출력, 배너 또는 세션 노이즈 없음. 동일한 에이전트와 도구; 파이프 및 스크립트에 최적.
hermes -z "…" --usage-file PATH -z 실행 후, 실행이 실패하더라도 JSON 사용량 보고서를 생성 (토큰, 비용, completed / failed / partial).
hermes chat -q "…" --format stream-json stdout에 JSONL 이벤트 출력 (system, text, tool_use, tool_result, result). 조용한 모드를 묵시적으로 적용하며 --tui를 거부.
hermes chat --quiet, -Q 더 조용한 프로그래밍 모드 (배너 및 도구 미리보기 억제). -q와 결합되면 원샷을 묵시적으로 적용.
-m / --model, --provider 실행별 모델 및 프로바이더 오버라이드; 환경 변수 HERMES_INFERENCE_MODEL / HERMES_INFERENCE_PROVIDER가 동일한 동작을 구현.
-t / --toolsets 실행을 위한 쉼표로 구분된 도구 세트 활성화.
-s / --skills 스킬 프리로드 (반복 또는 쉼표로 구분).
--image path 단일 쿼리에 로컬 이미지 첨부.
--checkpoints 파괴적 편집 전 파일시스템 체크포인트 활성화.
--max-turns N 턴당 도구 호출 반복 횟수 제한 (기본 500 또는 설정의 agent.max_turns).
--safe-mode 사용자 설정, 규칙, 메모리, 플러그인, 셸 훅, MCP 비활성화. --ignore-user-config 및 --ignore-rules를 묵시적으로 적용.
--source 세션 소스 태그 (통합을 위한 cli 대 tool). 원샷 실행은 기본적으로 oneshot.

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

종료 코드. chat --oneshot / -Q 실행은 턴이 완료되면 0, 실패하거나 중간에 중지되었거나, 반복 예산에 도달했거나, 시작되지 않으면 1, 인터럽트 시 130으로 종료됩니다. hermes -z는 다른 매핑을 사용합니다: 완료 시 0, 실패 또는 부분 완료 시 2 (설명을 출력했더라도), 텍스트를 생성하지 못한 완료된 턴 시 1, 인터럽트 시 130. 파이프라인의 결과를 stdout이 비어 있는지 여부가 아니라 코드로 판단하세요.

모델 피커, 자격 증명 풀, 폴백 프로바이더

명령어 설명
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 setup --portal 원샷 Nous Portal 로그인: OAuth, Nous를 추론 프로바이더로 설정, Tool Gateway 옵트인.
hermes portal [status | open | tools] Portal 인증 상태 및 Tool Gateway 라우팅. 서브커맨드가 없으면 status 실행.

hermes login은 제거되었습니다. OAuth 및 자격 증명 풀에는 hermes auth, 프로바이더 선택에는 hermes model, 전체 마법사에는 **hermes setup**을 사용하세요. hermes auth logout <provider>는 저장된 로그인을 지웁니다.

**hermes model**을 위한 로컬 OpenAI 호환 엔드포인트와 호스티드 API 선택은 일반적인 LLM 호스팅와 동일한 트레이드오프(지연, 비용, 운영)를 가집니다.

기본값이 Ollama 등에서 Qwen 또는 Gemma로 종료되는 경우, 입력한 모델 ID만큼이나 샘플러 기본값이 중요합니다; Qwen 3.6 및 Gemma 4의 벤더 및 커뮤니티 추론 매개변수를 에이전트 중심의 온도와 페널티 프리셋으로 정리한 내용은 Qwen 및 Gemma를 위한 에이전틱 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 설정 및 환경 파일 경로 출력.
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 worktree list 임시 워크트리 감사: 경과 시간, 크기, 삭제 안전성. 스크립트를 위한 --json.
hermes worktree prune 깨끗하고 병합된 임시 트리 제거. --dry-run은 계획 출력; --older-than N은 대상만 좁힘. 커밋되지 않은 작업이나 고유한 커밋이 있는 트리는 유지.

접착식 기본 프로필 프로필을 변경하지 않고 임시 실행을 위해 **hermes -p work chat -q "..."**를 사용하세요. TTY에서는 세션에 잔류하며, 프로필 실행이 종료되어야 하는 경우 **--oneshot**을 추가하세요.

스킬 허브, 도구 세트, 셸 훅, 플러그인

역할별 실제 생산 워크플로에 맞게 조정된 프로필 중심 구성 및 스킬에 대해서는 실제 생산 환경을 위한 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 gateway migrate [--dry-run] 프로필별 게이트웨이를 단일 호스트 게이트웨이로 통합. 프리플라이트가 차단하지 않는 한 hermes update이 이를 실행합니다. --standalone 롤백은 없습니다.
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, 프리셋, 선택적 시크릿).
hermes import-agent [claude-code | codex] Claude Code (~/.claude) 또는 Codex CLI (~/.codex) 설정 가져오기. 항상 미리보기를 먼저 수행하며, API 키는 절대 복사되지 않습니다. --sync는 파일이 변경된 소스를 다시 가져옵니다.

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 … 병렬 백그라운드 실행, 큐잉된 다음 프롬프트, 다음 도구 후 루프 중 나udge.
/goal … 판정 루프(status, pause, resume, clear)를 가진 영속적 멀티 턴 목표.
/branch, /fork 대안 탐구를 위해 대화 분기.
/btw … 현재 대화에 대한 부수 질문; 메인 턴을 중단하지 않음.
/context [all] 컨텍스트 사용량 분해. all은 스킬별 및 도구 세트별 비용을 추가.
/status 세션 정보 및 로컬 리캡 (최근 턴, 도구, 파일). 모델 호출 없음.
/sessions 세션 내 피커: 필터, 화살표, Enter로 재개.

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

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

사용량, 도움말, 종료

명령어 설명
/usage, /insights 토큰 및 비용 가시성; 분석 스냅샷.
/voice on, /voice tts CLI 음성 녹음 (기본 Ctrl+B) 및 음성 재생.
/reasoning high 세션의 추론 노력 향상.
/help, /quit 도움말 또는 CLI 종료.

**!**로 시작되는 줄은 모델 턴 없이 호스트 셸에서 실행됩니다 (!git status). 대화에 진입하지 않으며, 위험한 명령어는 여전히 승인 프롬프트에 도달합니다. Ctrl+S는 세션에만 컴포저 초안을 스테시하며, 디스크에 무엇도 기록되지 않습니다.

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

더 유용한 읽을거리

이 사이트의 관련 페이지:

공식 Hermes Agent 문서

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


팁. **hermes dump**와 **hermes doctor --fix**를 근육 기억에 새기세요 — 모호한 “무언가 깨졌다"는 보고서를 알려진 양호한 설정에 대한 실행 가능한 diff로 바꿔줍니다.

구독하기

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