AI 코딩 도구 설치·레퍼런스 (7/7) — Hermes Agent 명령어 치트시트: 30+ 서브커맨드

공식 /docs/reference/cli-commands 기준 verbatim 레퍼런스, 일상 사용 7개 · 심화 3개 · 세션 제어

핵심 요약

대상 독자: Hermes Agent를 설치했고(#12) 이제 전체 명령 지형을 보고 싶은 사용자.
얻을 것: 30+ 서브커맨드를 용도별 9개 카테고리로 분류, 글로벌 옵션 11개, hermes chat 옵션 10개, 세션 제어·슬래시 명령, 중단·복구 단축키.
선행 조건: hermes 정상 동작, 기본 setup 완료.

1. 하루에 쓰는 7개

명령	동작	언제 쓰는가
`hermes`	대화형 CLI 시작 (= `hermes chat`)	일반 세션
`hermes chat -q "..."`	1회성 비대화 쿼리	스크립트·파이프
`hermes -c` / `--continue`	가장 최근 세션 재개	터미널 닫고 돌아올 때
`hermes -r <id>` / `--resume`	특정 세션 재개 (ID 또는 타이틀)	명시적 세션 선택
`hermes status`	에이전트·인증·플랫폼 상태	뭔가 이상할 때 1차 체크
`hermes model`	provider·모델 전환	다른 모델 써야 할 때
`hermes doctor [--fix]`	환경 진단 (필요 시 자동 수정 시도)	설치 후·업데이트 후

2. 전체 서브커맨드 — 9개 카테고리

공식 /docs/reference/cli-commands 기준.

2.1 세션 & 채팅 (3개)

명령	구문	동작
`hermes chat`	`hermes chat [options]`	대화형/1회성 채팅
`hermes sessions`	`hermes sessions <sub>`	세션 목록·export·삭제·rename
`hermes insights`	`hermes insights [--days N] [--source]`	토큰·비용·활동 분석

2.2 설정 & 인증 (6개)

명령	구문	동작
`hermes setup`	`hermes setup [section]`	전체/부분 설정 위저드
`hermes model`	`hermes model`	provider·모델 선택
`hermes auth`	`hermes auth <sub>`	API 키·OAuth 자격 관리
`hermes config`	`hermes config <sub>`	config.yaml 표시·편집·migrate
`hermes tools`	`hermes tools [--summary]`	플랫폼별 도구 on/off
`hermes profile`	`hermes profile <sub>`	여러 격리 인스턴스 관리

2.3 Gateway & 채널 (3개)

명령	구문	동작
`hermes gateway`	`hermes gateway <sub>`	gateway 실행·서비스 관리
`hermes whatsapp`	`hermes whatsapp`	WhatsApp 브릿지 설정·페어링
`hermes pairing`	`hermes pairing <sub>`	페어링 코드 승인·취소

2.4 확장 & 지식 (5개)

명령	구문	동작
`hermes skills`	`hermes skills <sub>`	스킬 browse·install·publish·audit
`hermes mcp`	`hermes mcp <sub>`	MCP 서버 추가·제거·테스트
`hermes plugins`	`hermes plugins [sub]`	플러그인 관리
`hermes memory`	`hermes memory <sub>`	외부 메모리 프로바이더
`hermes honcho`	`hermes honcho <sub>`	Honcho 교차 세션 메모리

2.5 자동화 (2개)

명령	구문	동작
`hermes cron`	`hermes cron <sub>`	예약 작업 CRUD
`hermes webhook`	`hermes webhook <sub>`	웹훅 구독 관리

2.6 진단 & 로그 (4개)

명령	구문	동작
`hermes status`	`hermes status [--all] [--deep]`	전체 상태
`hermes doctor`	`hermes doctor [--fix]`	환경 진단
`hermes logs`	`hermes logs [log_name] [options]`	로그 조회·필터
`hermes debug`	`hermes debug share [options]`	지원용 로그·시스템정보 업로드

2.7 백업 & 이사 (3개)

명령	구문	동작
`hermes backup`	`hermes backup [options]`	`~/.hermes/` 전체 zip 백업
`hermes import`	`hermes import <zipfile>`	백업 복원
`hermes claw`	`hermes claw migrate [options]`	OpenClaw 마이그레이션

2.8 유틸 (4개)

명령	구문	동작
`hermes dump`	`hermes dump [--show-keys]`	복붙 가능한 설정 요약
`hermes dashboard`	`hermes dashboard [options]`	웹 대시보드 실행
`hermes completion`	`hermes completion [bash\\|zsh]`	셸 자동완성 스크립트
`hermes acp`	`hermes acp`	에디터용 ACP stdio 서버

2.9 유지보수 (3개)

명령	구문	동작
`hermes version`	`hermes version`	버전 표시
`hermes update`	`hermes update`	최신 코드 pull + 의존성 재설치
`hermes uninstall`	`hermes uninstall [--full] [--yes]`	시스템에서 제거

3. 글로벌 옵션 (모든 커맨드 공통)

옵션	동작
`--version`, `-V`	버전 출력 후 종료
`--profile <name>`, `-p <name>`	프로파일 선택
`--resume <session>`, `-r <session>`	ID 또는 타이틀로 세션 재개
`--continue [name]`, `-c [name]`	최근 세션 재개 (이름 선택)
`--worktree`, `-w`	격리된 git worktree에서 시작
`--yolo`	위험 명령 승인 프롬프트 무시 (매우 위험)
`--pass-session-id`	system prompt에 세션 ID 포함
`--ignore-user-config`	`~/.hermes/config.yaml` 무시
`--ignore-rules`	rules·memory 자동 주입 스킵
`--tui`	클래식 CLI 대신 TUI
`--dev`	tsx로 TypeScript 소스 직접 실행

4. `hermes chat` 옵션 (자주 쓰이는 것)

옵션	동작
`-q, --query "..."`	1회성 비대화 프롬프트
`-m, --model <model>`	이번 실행만 모델 override
`-t, --toolsets <csv>`	콤마 구분 toolset 활성화
`--provider <provider>`	특정 provider 강제
`-s, --skills <name>`	스킬 프리로드 (반복 가능)
`-v, --verbose`	상세 출력
`-Q, --quiet`	프로그래매틱 모드
`--image <path>`	로컬 이미지 첨부
`--checkpoints`	파일시스템 체크포인트 활성
`--max-turns <N>`	도구 반복 횟수 상한

예 — Anthropic 모델 + 토큰 프리로드:

hermes chat \
  --provider anthropic \
  --model "anthropic/claude-sonnet-4" \
  --toolsets "web,terminal,skills" \
  -s github-auth \
  -q "최근 PR 3개 요약"

5. Gateway 서브커맨드

sub	동작
`run`	포그라운드 실행
`start`	systemd/launchd 백그라운드 서비스 시작
`stop`	서비스 또는 포그라운드 중단
`restart`	서비스 재시작
`status`	서비스 상태
`install`	백그라운드 서비스로 등록
`uninstall`	서비스 등록 해제
`setup`	메신저 플랫폼 대화형 세팅

24/7 서버 운영: hermes gateway install → hermes gateway start.

6. Setup 섹션

hermes setup 단독 실행은 전체 위저드. 특정 섹션만:

섹션	커버
`model`	provider + 모델
`terminal`	터미널 백엔드·샌드박스
`gateway`	메신저 플랫폼
`tools`	플랫폼별 도구 토글
`agent`	에이전트 동작

옵션: --non-interactive, --reset.

7. 세션 내부 슬래시 명령 (공식 + 실전)

공식 문서가 명확히 나열한 것 + hermes -c로 들어간 세션 안에서 확인 가능한 것.

명령	동작
`/help`	도움말
`/new`	새 대화 시작
`/reset`	컨텍스트 리셋
`/model`	현재 모델 표시/전환. `--global`로 config.yaml 반영
`/personality [name]`	세션 페르소나 오버레이
`/retry`	마지막 응답 재생성
`/undo`	되돌리기
`/compress`	대화 요약·압축
`/usage`	토큰/비용 조회
`/insights`	세션 분석
`/skills`	로드된 스킬 목록
`/skills browse`	스킬 허브 브라우즈
`/tools`	사용 가능한 도구 표시
`/background <prompt>`	분리된 백그라운드 세션 실행
`/voice on`	음성 모드 활성 (`Ctrl+B`로 녹음)
`/voice tts`	TTS 응답 토글
`/reasoning high`	추론 effort 상승
`/title My Session`	현재 세션 명명
`/verbose`	verbose 모드 순환 (off → new → all → verbose)
`/stop`	실행 중 작업 중단

대소문자 무관: 공식 명시 — /HELP와 /help가 동일.

8. 인증 · 크론 · 웹훅 서브커맨드

8.1 `hermes auth`

hermes auth add <provider> [--api-key <key> | --type oauth]
hermes auth list [provider]
hermes auth remove <provider> <index>
hermes auth reset <provider>   # cooldown 초기화

Provider별 복수 키 등록 가능 (rate-limit 분산용).

8.2 `hermes cron`

sub	동작
`list`	예약 작업 목록
`create`	새 작업 (스킬 지정 가능)
`edit`	스케줄·프롬프트·스킬 수정
`pause` / `resume`	일시 정지·재개
`run`	다음 tick에 강제 실행
`remove`	삭제
`status`	스케줄러 동작 여부
`tick`	즉시 due 작업 1회 실행 후 종료

8.3 `hermes webhook`

hermes webhook subscribe <name> \
  --prompt "주어진 이벤트를 요약" \
  --events "push,pr_merged" \
  --description "GitHub 이벤트 요약" \
  --skills "github-summary" \
  --deliver telegram \
  --deliver-chat-id 123456 \
  --secret $WEBHOOK_SECRET

hermes webhook list
hermes webhook test <name>
hermes webhook remove <name>

9. 로그 조회

hermes logs                # 기본 (50줄)
hermes logs agent          # 에이전트 로그
hermes logs errors         # 에러만
hermes logs gateway        # 게이트웨이
hermes logs list           # 로그 파일 목록

hermes logs -f
hermes logs -f --level ERROR

hermes logs --session abc123

hermes logs --since 30m
hermes logs --since 2h
hermes logs --since 1d

hermes logs --component gateway

10. 스킬 · MCP · 플러그인

10.1 `hermes skills`

sub	동작
`browse`	페이징 레지스트리 브라우저
`search`	레지스트리 검색
`install`	설치
`inspect`	미리보기 (설치 안 함)
`list`	설치된 스킬 목록
`check`	업스트림 업데이트 확인
`update`	업스트림 변경 반영
`audit`	이슈 재스캔
`uninstall`	제거
`publish`	레지스트리에 게시
`snapshot`	설정 export/import
`tap`	커스텀 스킬 소스 관리
`config`	플랫폼별 enable/disable

10.2 `hermes mcp`

hermes mcp add <name> [options]    # MCP 서버 추가
hermes mcp list                    # 목록
hermes mcp test <name>             # 연결 테스트
hermes mcp configure <name>        # 도구 선택 토글
hermes mcp remove <name>           # 제거
hermes mcp serve [-v]              # Hermes 자체를 MCP 서버로

10.3 `hermes plugins`

sub	동작
(인자 없음)	복합 UI: 플러그인 토글 + provider 설정
`install`	Git URL 또는 `owner/repo`에서 설치
`update`	최신 pull
`remove`	삭제
`enable` / `disable`	활성/비활성
`list`	상태 포함 목록

11. 프로파일 — 여러 격리 인스턴스

sub	구문	동작
`list`	`hermes profile list`	프로파일 목록
`use`	`hermes profile use <name>`	기본 프로파일 설정
`create`	`hermes profile create <name> [--clone\\|--clone-all\\|--clone-from]`	새 프로파일
`delete`	`hermes profile delete <name> [-y]`	삭제
`show`	`hermes profile show <name>`	상세
`alias`	`hermes profile alias <name> [--remove\\|--name]`	래퍼 스크립트 관리
`rename`	`hermes profile rename <old> <new>`	이름 변경
`export`	`hermes profile export <name> [-o FILE]`	.tar.gz로 export
`import`	`hermes profile import <archive> [--name]`	가져오기

프로파일은 work / personal 등 완전히 분리된 hermes 상태를 유지할 때 유용. 각각 다른 ~/.hermes/profiles/<name>/ 디렉터리.

12. 메모리 프로바이더

hermes memory setup     # 대화형 선택
hermes memory status    # 현재 설정
hermes memory off       # 외부 provider 비활성

지원 provider (공식): honcho, openviking, mem0, hindsight, holographic, retaindb, byterover, supermemory.

Honcho dialectic 모델은 hermes honcho로 별도 관리 (peers·sessions·modes·tokens 등 세부 설정).

13. 단축키 & 중단

키	동작
Enter (에이전트 작업 중)	현재 작업 인터럽트 + 새 메시지 처리
Ctrl+C	중단. 2초 이내 두 번 누르면 강제 종료
Ctrl+Z (Unix)	백그라운드 서스펜드. `fg`로 복귀
Ctrl+B (voice on 상태)	음성 녹음

14. 세션 영속성 — 위치와 행동

공식 명시:

상태 DB: ~/.hermes/state.db (SQLite)
저장: 메타데이터, 메시지 히스토리, lineage, 풀텍스트 인덱스
자동 컨텍스트 압축: 중간 턴을 요약, 첫 3턴 + 마지막 4턴은 항상 보존

세션 탐색:

hermes sessions list            # 최근 목록
hermes sessions browse          # 인터랙티브 검색
hermes sessions export          # JSONL
hermes sessions rename <id>     # 제목 변경
hermes sessions prune --days 90 # 오래된 세션 삭제
hermes sessions stats           # 저장소 통계

15. 자주 쓰는 조합 10가지

hermes chat -q "이 에러 원인은?"

hermes chat -m "anthropic/claude-sonnet-4" -q "..."

hermes -c

hermes -s github-auth -q "최근 오픈 이슈 3개"

hermes dump | pbcopy   # macOS

hermes backup -o ~/hermes-backup-$(date +%Y%m%d).zip

hermes logs -f --level ERROR

hermes gateway install && hermes gateway start

hermes -p work chat -q "이번 주 스탠드업 정리"

hermes claw migrate --dry-run
hermes claw migrate --preset full --migrate-secrets

16. 반대 시나리오 — 이 치트시트가 불필요한 경우

단순 CLI 대화만 → hermes 한 줄이면 충분. 나머지는 필요할 때만 훑어보면 됨.
Hermes 초기 버전 문제 있음 → 2026-02 릴리즈 후 명령 추가·변경이 잦다. 이 치트시트도 last verified 날짜 확인 필수.
자동화가 아니라 학습 목적 → hermes doctor·hermes status만 알고 시작. 나머지는 자연스럽게 마주치며 학습.

17. 다음 단계

명령 지형이 잡혔다면:

설치 완전판 + SOUL.md — 아직 설치 전이면 먼저.
영속 메모리 FTS5 실전 (예정) — hermes memory·hermes honcho 심화.
OpenClaw → Hermes 마이그레이션 체크리스트 (예정) — hermes claw migrate 옵션 전부.

참고

이 글은 "AI 코딩 CLI 진입 가이드" 시리즈의 13/15 편입니다. last verified: 2026-04-25 (hermes-agent.nousresearch.com/docs/reference/cli-commands 및 user-guide/cli 기준).

시리즈 전체 안내: 시리즈 목차

이 블로그 검색

MaJu's Note