Hermes Agent 확장 oh-my-hermes 설치·보안·제거 직접 검증

Hermes Agent를 쓰는데 매번 같은 지시를 반복하거나, 세션이 끝나면 맥락이 사라지거나, 어떤 스킬을 불러야 할지 에이전트 스스로 못 찾는 사람에게 유용한 게 oh-my-hermes(OMH)다. Hermes에 워크플로 123종과 장기 기억 프로바이더, 상태 표시(HUD)를 한 번에 얹는 운영 계층 플러그인이며, Claude Code용 obra/superpowers와 비교하면 “다른 호스트를 위한 같은 계열의 도구”다. 핵심 주의점은 두 가지다. 설치 시 Hermes 설정 깊숙이 들어가 memory.provider를 교체하고, omh uninstall --all로 제거해도 config.yaml 등록은 되돌리지 않아 수동 정리가 필요하다. 이 글의 모든 설치·진단·제거는 격리 임시 홈에서 직접 실행해 확인했다.

핵심 요약

무엇: Hermes Agent 전용 올인원 플러그인. 기획·리서치·리뷰·운영 등 123개 워크플로 스킬, 파일 기반 장기 기억 프로바이더, 실행 비용·상태를 보여주는 HUD를 함께 넣는다.
누구에게: Hermes Agent를 설치는 했지만 스킬을 하나씩 골라 붙이기보다 검증된 묶음으로 시작하고 싶은 사람, 세션 간 기억과 작업 흐름 표준화가 필요한 사람.
핵심 차이: oh-my-zsh이 셸에 프레임워크를 얹듯 Hermes에 “운영 계층”을 얹는다. 개별 스킬 모음이 아니라 라우팅·기억·보고가 함께 동작한다.
주의: 설치가 Hermes config.yaml의 스킬 경로, 플러그인 목록, memory.provider, 스킨까지 바꾼다. 제거 커맨드는 파일·디렉터리만 지우고 설정 등록은 남긴다. 백업과 수동 복구 절차가 필수다.
검증 기준일: 2026-09-15, npm 버전 2.0.3(2026-09-12 발표) 기준. GitHub 1,990★, 159 포크.

도구 정보와 실제 증가 속도

항목	값
이름·유형	oh-my-hermes (OMH) — Hermes Agent 플러그인 + 유지관리 CLI
공식 저장소	github.com/rlaope/oh-my-hermes
npm 패키지	oh-my-hermes 2.0.3 (2026-09-12 게시)
라이선스	MIT
저장소 생성	2026-06-03
최신 푸시	2026-09-14 (일일 커밋 활발)
최근 릴리스	v2.0.3(09-12), v2.0.2(09-07), v2.0.1(09-05), v2.0.0(08-29) — 2~5일 간격
기여자	4명 실질 기여(1,732 / 1,032 / 580 커밋) + dependabot
스타	1,990★ (2026-09-15 기준, 이날 GitHub Trending 일간 목록에도 등장)
스타 증가	이 레이더에서 오늘 최초 추적 — 증분 없음(초회 관측, provisional)
npm 주간 다운로드	254회/주 (2026-09-05~09-11), 월간 1,462회
이슈	열림 13건

스타 증가율 수치는 오늘 처음 스냅숏을 잡은 관계로 provisional(초회 관측)이며 실제 일별 증분이 아니다. 대신 확인 가능한 활동 신호는 릴리스 주기(8월 말부터 6회), 일일 커밋, npm 게시 이력이다. 커뮤니티 신호로는 공식 Discord, 제작자 X(@rlaope) 계정, 한국어 LinkedIn 소개 글, skillsllm.com 에이전트 카탈로그 등재가 있다. Hacker News 논의는 아직 없다.

설치하면 무엇이 바뀌나 — 직접 검증 결과

격리된 임시 홈(/tmp)에서 npm tarball을 내려 받아 vendored wheel(oh_my_hermes-2.0.3-py3-none-any.whl, SHA256 고정)을 가상환경에 설치하고 omh --hermes-home <격리경로> setup을 실행했다. 실제 사용자 홈은 두 번째 실행부터 건드리지 않았음을 파일 시스템 타임스탬프로 확인했다.

설치 결과:

~/.omh/skills/에 123개 워크플로 스킬 생성(안내·리서처·플래너·리뷰어·운영자 등 9개 역할 그룹)
<hermes-home>/plugins/omh/에 대형 플러그인 번들 설치(메모리 프로바이더, 브라우저 브리지, 훅, 거버넌스 모듈 포함)
Hermes config.yaml에 4군데 변경: skills.external_dirs에 스킬 경로 추가, plugins.enabled에 omh 추가, memory.provider: omh 설정(기억 글자上限 2200→4000, 1375→2000으로 함께 변경), display.skin: omh 지정
TUI 위젯(tui-widgets/omh-status.mjs)과 스킨 4종 추가

진단:omh doctor는 격리 환경에서 44/44 통과(0 blocking, 경고 3개는 PATH 미등록 등 운영성 항목)였다.

제거:omh uninstall --all은 ~/.omh와 plugins/omh 디렉터리를 지운다(실제 로그로 확인). 그러나 config.yaml의 네 가지 등록은 그대로 남는다. 재설치 후 다시 제거해도 동일했다. 완전한 원상복구에는 config.yaml 수동 편집이 필요하다.

요구 권한·보안 검토

설치 경로: 공식 install.sh(531줄)은 자기 GitHub 저장소와 릴리스에서만 내려 받는다. sudo 사용은 없었다. venv는 ~/.local/share/omh 아래에 만든다.
npm 공급망: 런타임 의존성 0개, 파이썬 휠을 패키지 안에 동봉하며 SHA256(wheelSha256, cacheTreeSha256)을 manifest에 고정해 무결성을 검사한다. npm provenance 게시 활성화 상태다.
LLM 호출: 라이브러리 안에 LLM 클라이언트가 없다. 판단은 호스트 CLI(Hermes가 쓰는 모델)를 빌려 쓰고, 별도 API 키가 필요 없다는 게 README의 설명이고, 설치 과정에서 키 입력을 요구하지 않은 것으로 확인됐다.
네트워크: 플러그인에 egress 시도 영수증(egress_attempts) 모듈이 있어 외부 전송을 거버넌스로 기록·통제하는 구조다. 텔레메트리는 준비도 프로브·실행 요약류이며 옵트인(기본 꺼짐)이라고 문서에 명시돼 있다.
침입성(가장 중요): memory.provider: omh는 Hermes 기본 기억 시스템을 OMH 것으로 교체한다. isolation 검증 중 인자 순서를 잘못 써서 --hermes-home 없이 실행한 적이 있었는데, 이때 실제 사용자 ~/.hermes의 config.yaml·플러그인·스킨이 수정됐다. 곧바로 백업본 기준으로 전부 원상복구했고(파일·설정 모두 정상 확인), 이 경험 자체가 “명시적 hermes-home 지정 없이는 운영 환경을 침범할 수 있다”는 실측 경고가 된다.
비용: 도구 자체는 무료(MIT). 실행 비용은 Hermes가 쓰는 모델 usage 그대로다. HUD가 실행별 토큰·달러를 계산해 보여준다.

기존 유명 도구와 비교 — superpowers와는 무엇이 다른가

Agent 스킬 프레임워크로 자주 비교되는 대표 도구와의 관계를 정리한다.

비교 항목	oh-my-hermes	obra/superpowers (Claude Code)	Hermes 기본 스킬
대상 호스트	Hermes Agent 전용	Claude Code 중심(다른 CLI로 이식 사례 다수)	Hermes 자체
규모	스킬 123종 + 기억 + HUD 통합	스킬 다수(브레인스토밍·디버깅·계획 등)	번들 스킬 제공
기억 계층	파일 기반 프로바이더로 호스트 기억 교체	별도 기억 계층은 아님(호스트 의존)	세션 메모리(기본)
입력·출력	Hermes 대화 → 계층적 워크플로 실행·보고	Claude 대화 → 스킬별 절차	Hermes 대화 → 단일 스킬
모델 라우팅	카테고리별 모델 체인 구성(`omh model-chains`)	없음	없음
비용 모델	무료, 실행 비용 HUD 표시	무료(MIT)	무료
제거	파일은 커맨드 제거, 설정 수동	스킬 디렉터리 제거로 완결	내장

관계 분류: 보완재(허점을 메우는 관계)다. superpowers가 Claude Code 생태계의 사실상 표준 스킬 팩이라면, OMH는 Hermes 생태계에서 같은 역할을 하려는 도구다. 두 에이전트를 함께 쓰는 사람에게는 각 호스트에 각각 두는 것이고, Hermes만 쓰는 사람에게는 superpowers 대신이 아니라 “Hermes에는 superpowers가 없으므로 그 자리를 채우는 선택지”다. superpowers(28.6만★)나 Anthropic 공식 스킬(17.6만★) 대비 역사와 검증 규모는 작지만(약 2천★), Hermes Agent 자체가 24.5만★로 한국어 사용자가 빠르게 늘고 있는 호스트라는 점이 이 도구의 의미다.

Claude Code / Codex / Hermes별 설치·연결 방법

OMH는 Hermes Agent 플러그이다. Claude Code와 Codex에는 설치 대상이 없다는 점을 먼저 명확히 한다(에이전트가 이 글을 읽고 OMH를 설치하려는 경우 아래 안전 프롬프트를 사용한다).

Hermes Agent에 설치(공식 절차)

전제: Hermes Agent가 설치돼 있고 Python 3.11+, Node 18+.
원라인 설치: curl -fsSL https://raw.githubusercontent.com/rlaope/oh-my-hermes/main/install.sh | sh
설정: omh setup — 단, 운영 홈이 아닌 별도 홈에서 시험할 때는 반드시 omh --hermes-home <경로> setup처럼 전역 인자를 서브커맨드 앞에 둔다. 뒤에 붙이면 무시되고 기본 홈을 수정한다(실측).
확인: omh doctor — 44개 검사가 모두 통과해야 정상.
Hermes 재시작 후 대화에서 워크플로가 인식되는지 확인.

바뀌는 경로(설치 시 생성)

~/.omh/ — 스킬 123종, 런타임 상태
<hermes-home>/plugins/omh/ — 플러그인 번들
<hermes-home>/tui-widgets/omh-status.mjs, <hermes-home>/skins/omh*.yaml
<hermes-home>/config.yaml — 앞서 나열한 4군데 수정

제거·원상복구

omh uninstall --all — ~/.omh, 플러그인 디렉터리 삭제(커맨드 패키지는 설치 방식에 따라 npm uninstall -g oh-my-hermes 또는 brew uninstall omh)
config.yaml 수동 복구 — skills.external_dirs의 omh 경로 삭제, plugins.enabled에서 omh 제거, memory.provider: omh 줄 삭제(기억 한도도 원복), display.skin 원복
변경 전 config.yaml 백업이 있으면 그것으로 되돌리는 것이 가장 확실하다

Claude Code / Codex 사용자: 이 도구는 두 에이전트의 확장이 아니다. Hermes Agent를 별도로 운영 중이라면 그 Hermes에만 설치한다.

안전한 복사·붙여넣기 프롬프트

이 글의 URL을 에이전트(Claude Code, Codex, Hermes)에 붙여 넣고 설치를 맡길 때 쓸 프롬프트다. 운영 환경 보호를 위해 그대로 사용하기를 권한다.

https://blog.kwt.co.kr/ 에 안내된 oh-my-hermes(OMH)를 설치해줘. 다음 규칙을 지켜.

1. 버전 고정: npm 패키지 oh-my-hermes 2.0.3을 쓴다. 설치 후 `omh --version`으로 2.0.3인지 확인하고 다르면 중단·보고해.
2. 사전 백업: ~/.hermes/config.yaml이 있으면 타임스탬프 붙은 복사본을 만들어. 설치 전 백업이 없으면 진행하지 마.
3. 격리 먼저: 먼저 임시 디렉터리(예: /tmp/omh-trial)에 HOME을 두고 시험 설치한다. `omh --hermes-home /tmp/omh-trial/.hermes setup`처럼 전역 인자(--hermes-home)를 서브커맨드 앞에 쓴다. 인자를 뒤에 붙이면 실제 홈이 수정되니 주의.
4. 진단: `omh --hermes-home /tmp/omh-trial/.hermes doctor`가 44/44 통과인지 확인하고 결과를 그대로 보여줘.
5. 실제 설치 승인: 격리 검증 결과를 보고한 뒤, 내가 명시적으로 "실제 홈에 설치"라고 답할 때까지 실제 ~/.hermes는 건드리지 마.
6. 권한 확인: 설치 중 API 키 입력, 비밀 입력, sudo를 요구하면 중단하고 보고해.
7. 제거 실습: 격리 환경에서 `omh uninstall --all`을 실행해 파일이 지워지는 것과 config.yaml에 omh 등록이 남는 것을 확인·보고해. config 복구는 백업본으로 하는 법을 함께 보여줘.
8. 금지: 운영 프로젝트 디렉터리 변경, 실제 사용자 홈 설정 변경(5번 승인 전), 비용 결제, credentials 열람.

직접 검증한 것과 못 한 것

직접 실행해 확인한 것(2026-09-15, npm 2.0.3 tarball)

npm 패키지 구조: 의존성 0, vendored 휠 SHA256 고정, provenance 필드
격리 홈 설치: 스킬 123종 생성, config.yaml 4군데 수정, TUI 위젯·스킨 설치
omh doctor 44/44 통과
omh uninstall --all의 파일 제거와 config 미복구 동작
인자 순서 오용 시 실제 홈 수정 동작(발견 즉시 원상복구 완료)

검증하지 못한 것

Hermes 실세션에서의 워크플로 실행 품질(기억 저장·라우팅 정확도) — 설치·진단까지만 무해 검증
Windows PowerShell 설치 경로
장기 운영 시 안정성과 업데이트(omh update) 동작
README가 제시하는 성능 수치(별도 벤치마크 아님, 독립 검증 없음)

유용한 경우 / 추천하지 않는 경우

유용한 경우

Hermes Agent를 본격 작업 호스트로 쓰면서 스킬을 일일이 구성할 시간이 없을 때
세션 간 프로젝트 기억이 필요하고, 파일 기반(그리프 가능) 기억을 선호할 때
여러 작업 유형(리서치·기획·리뷰·운영)에 표준 절차를 물리고 실행 비용을 HUD로 감시하고 싶을 때

추천하지 않는 경우

Hermes를 가볍게만 쓰는 경우 — 기본 기능으로 충분하고 설정 침입성이 손해다
config.yaml을 직접 관리하며 민감하게 쓰는 경우 — 제거 시 수동 복구가 부담이면 피한다
Claude Code/Codex 중심 사용자 — 이 도구는 그 대상이 아니다(superpowers 등 해당 생태계 도구를 쓴다)
운영 환경에서 즉시 쓰려는 경우 — 반드시 격리 검증 후 도입한다

자주 묻는 질문(FAQ)

oh-my-zsh과 같은 건가요?

이름에서 따온 건 맞다. 셸에 프레임워크를 얹듯 Hermes에 운영 계층을 얹는다는 관점은 같다. 다만 셸 스크립트 모음과 달리 기억 프로바이더 교체·모델 라우팅처럼 호스트 동작에 깊이 관여한다는 점이 다르다.

Claude Code에서도 쓸 수 있나요?

아니다. Hermes Agent 전용 플러그이다. Claude Code에는 superpowers 같은 대응 생태계가 있다.

제거하면 Hermes가 망가지나요?

omh uninstall --all 후 config.yaml의 omh 등록을 수동으로 지우지 않으면 Hermes가 없는 경로·프로바이더를 참조할 수 있다. 설치 전 config.yaml 백업이 필수인 이유다.

API 키가 추가로 필요한가요?

필요하지 않다. 판단은 Hermes가 이미 쓰는 모델 연결을 빌려 쓴다(README 명시, 설치 중 키 요구 없음으로 확인).

데이터가 외부로 나가나요?

라이브러리에 LLM 클라이언트가 없고 기억은 로컬 파일 기반이다. 텔레메트리는 옵트인이다. 설치·설정 단계에서 외부 전송을 요구하는 동작은 관찰되지 않았다. 다만 에이전트 플러그인 특성상 실행 시 호스트 권한을 쓰는 만큼, 민감 저장소가 있는 환경이라면 격리 검증 후 도입한다.

확인된 참고 자료

공식 저장소: https://github.com/rlaope/oh-my-hermes
설치 문서: https://github.com/rlaope/oh-my-hermes/blob/main/docs/INSTALLATION.md
한국어 README: https://github.com/rlaope/oh-my-hermes/blob/main/README.ko.md
npm 패키지: https://www.npmjs.com/package/oh-my-hermes
Hermes Agent(호스트): https://github.com/NousResearch/hermes-agent
비교 대상 superpowers: https://github.com/obra/superpowers
제작자 소개(LinkedIn, 한국어): https://kr.linkedin.com/posts/esperer_github-rlaopeoh-my-hermes-the-agent-engineering-activity-7498651733376696320-TNID
기준일: 2026-09-15. 스타·다운로드 수치는 이날 실측이며 이후 변동될 수 있다.

Hermes Agent를 “내 업무용 도구”로 바꾸는 oh-my-hermes: 설치·보안·제거 직접 검증