oh-my-hermes 저장소 요약

개요

oh-my-hermes(OMH)는 hermes-agent 위에 올라가는 운영 레이어다. 기존 Hermes 워크플로우를 대체하지 않고 강화하며, 명시적 증거 경계를 갖춘 계획, 조사, 생성, 코딩 인수인계, 운영, 프로젝트 메모리 기능을 제공한다. OMH는 Hermes 네이티브 스킬 위의 운영 레이어로, 문제를 프레임하고 워크플로우와 증거 게이트를 선택하며, 그 관리된 경로 안에서 네이티브 스킬을 기능으로 실행한다.

저장소는 2,332 커밋, 1.1k 스타, 106 포크를 기록 중이며 Team Art & Engineering에서 공개 개발한다.

핵심 기능 (8가지 Ultra-Skills)

OMH는 8개의 ulw- 워크플로우를 제공한다. 각각 채팅에서 트리거를 말하면 Hermes가 나머지를 라우팅한다.

워크플로우	설명
ulw-context	검토된 프로젝트 용어 정렬, 확인된 후보 캡처, 용어 라우팅 권한 없이 다음 결정 경계 인터뷰
ulw-interview	원하는 것을 정확히 알 때까지 한 번에 하나씩 질문
ulw-research	실제 코드와 라이브 웹 조사, 출처 유지, 의심스러운 것 검증
ulw-plan	옵션 비교, 위험 명시, 완료 기준을 합의한 검토된 계획
ulw-work	같은 파일을 건드리지 않는 병렬 레인에서 승인된 계획 실행
ulw-loop	계획 → 빌드 → 리뷰 사이클 (목표가 실제로 통과할 때까지)
ulw-qa	적대적 시나리오로 빌드 공격, 깨진 것 수정
ulw-perf	실제 느리거나 비싼 지점 측정 후 한 번에 하나씩 수정

핵심 특징

• 🧭 Mixture-of-models 라우팅 — 각 위임 레인을 카테고리(모델 + 추론 노력)에 라우팅, 편집 가능한 대체 체인, provider 거절 시 체인 진행, 작업이 없을 때 정직한 failed 행
• 🖥️ 네이티브 TUI 표면 — OMH HUD(카테고리, 턴, 비용, 캐시 포함 실시간 위임 행), 프롬프트 위 단계별 TODO 체크리스트, parallel shot ×N 브랜딩, 전체 행 diff 밴드, 관리형 스킨 — Hermes 옆에 설치, 패치하지 않음
• 📋 단계별 계획 — todo init으로 엔진 작업 전 단계와 태스크 선언, 개방형 추론 루프 대신 bounded 체크리스트 실행
• ⚡ 관찰된 병렬 작업 — 독립적인 작업을 명시적 팬아웃 단위로 분리, 격리된 소유권, 진행 관찰, 검증 게이트
• 🎼 Maestro 인수인계 — 명시적 코딩 소유자 및 런타임 프로파일로 인수인계 준비, 숨겨진 실행자 역할 금지, 준비 = 실행 취급 금지
• 🧠 문맥 지능 — 압축된 검토된 저장소 문맥 제공, 숨겨진 메모리 생성이나 선택된 경로 무단 변경 금지
• 📚 적시 학습 — 현재 차단 지점에 대한 최고 가치 학습 대상 선택, 소스 기반 애플리케이션 우선 지침 준비, 학습 완료 주장 금지
• 🔍 증거 기반 전달 — 준비 의도, 관찰된 런타임 활동, 검증된 결과를 코딩·리뷰·CI·병합 작업에서 분리
• 📦 결정적 스킬 카탈로그 — 100+ 설치 가능 워크플로우 스킬, byte-exact 생성 카탈로그, 라우팅 정밀도 말뭉치(네거티브 제어 포함), 1문자 편차 시 CI 실패하는 drift 게이트

이 특징 묶음은 moc-ai-agents-harness MOC에서 다루는 주제 — 특히 harness 개념과 연결된다.

증거 기반 상태

OMH는 작업이 일어났다고 보고하지 않으며, 실제로 일어나는 것을 관찰한 경우에만 보고한다. 모든 상태에는 단계와 OMH의 확신도 두 부분이 있다.

표시되는 상태	의미
Plan · not run	프롬프트/계획 준비 완료. 아직 실행된 것 없음
Code · running	실행자가 현재 실행 중, OMH가 관찰 중
Code · reported done	실행자가 완료 보고. 결과를 아무도 확인하지 않음
Test · verified	테스트/리뷰/CI 게이트가 실제로 통과

핵심 구분: 실행자가 완료되었다고 보고한 것 ≠ 아무것도 확인되지 않음. 자세한 내용은 저장소 내 Capability Impact 문서 참조.

이 증거 구분은 2026-08-30-evidence-based-verification 노트의 원칙과 맞닿아 있다.

설치 방법

패키지 관리자

# Homebrew
brew install rlaope/tap/omh
 
# Bun (권장)
bun install -g oh-my-hermes
 
# npm
npm install -g oh-my-hermes
 
# Universal installer (macOS/Linux)
curl -fsSL https://raw.githubusercontent.com/rlaope/oh-my-hermes/main/install.sh | sh
 
# Windows (PowerShell 5.1+)
iwr https://raw.githubusercontent.com/rlaope/oh-my-hermes/main/install.ps1 -UseBasicParsing | iex

설정 / 업데이트 / 확인

omh setup       # 설치 후 구성
omh update      # 설치 방법 감지 후 자동 업그레이드
omh doctor      # 설치 검증/문제 해결

제거

# 전체 제거
omh uninstall --all
brew uninstall omh              # Homebrew
bun remove -g oh-my-hermes      # Bun
npm uninstall -g oh-my-hermes   # npm

Hermes 스킬 탭 경로

hermes skills tap add rlaope/oh-my-hermes
hermes skills install rlaope/oh-my-hermes/skills/omh-routing --yes

모델 추천 체인

OMH는 편집 가능한 순서형 추천 체인을 제공하며, omh setup이 해결한다. 사용자 확인된 활성 후보에 대해서만 적용하고, 결과는 라우팅 구성일 뿐 provider可用성/자격증명/디스패치/실행 증거가 아니다.

카테고리	용도	추천 순서
ultrabrain	가장 깊은 추론	GPT-5.6 Sol
deep	강한 기본 티어	GPT-5.6 Terra → DeepSeek V3.2
architect	아키텍처/시스템 설계	Claude Fable 5 → GPT-5.6 Sol → Kimi K3 (xhigh)
unspecified-high	기본 작업 모델	Kimi K3 → Claude Opus 5
unspecified-low	저렴한 대체	GLM 5.2 → GLM 5.2 Ultrafast → DeepSeek V3.2 → Claude Opus 5 (low)
quick	짧은 작업	GLM 5.2 Ultrafast → Kimi K3 → GPT-5.6 Luna → Claude Fable 5 (low)
writing	산문/문서	Kimi K3 → Qwen3-Coder → Gemini 3.1 Pro
visual-engineering	프론트엔드/시각	Claude Fable 5 → Kimi K3
artistry	비전통적 작업	Gemini 3.1 Pro → Claude Fable 5 → Kimi K3

체인은 categories 파일에서 편집 가능. omh model-chains show로 확인, omh model-chains set <category> "<model:effort,...>"로 CLI 변경.

모델 라우팅 개념은 model-routing-switchyard 노트와 연결된다.

저장소 구조

oh-my-hermes/
├── .claude/skills/        # Claude 스킬
├── .codegraph/            # 코드 그래프
├── .github/               # GitHub 워크플로우/이슈 템플릿
├── .omh/                  # OMH 설정
├── assets/                # 이미지/미디어
├── benchmarks/            # 벤치마크
├── docs/                  # 문서
├── examples/              # 예제
├── omh/                   # OMH 코어 패키지
├── packaging/             # 패키징
├── roles/                 # 역할 정의
├── script/qa/             # QA 스크립트
├── site/                  # GitHub Pages 사이트
├── skills/                # 스킬 정의
├── src/                   # 소스 코드
├── tests/                 # 테스트
└── tools/                 # 도구

주요 문서:

• docs/README.md — 문서 맵
• docs/INSTALLATION.md — 설치/업데이트/가이드 모델 설정
• docs/DIRECTION.md — 제품 방향/경계
• docs/ARCHITECTURE.md — 아키텍처
• docs/CAPABILITIES.md — 기능 매니페스트
• docs/WORKFLOWS.md — 워크플로우 레퍼런스
• docs/ROLES.md — 역할
• docs/APPLICATION_CASES.md — 적용 사례
• docs/RELEASE.md — 릴리스/개발
• CAPABILITY_IMPACT.md — 기능 영향

CI 체크리스트 (소스 체크아웃)

PYTHONPATH=tests uv run python -m unittest discover -s tests -v
uv run python -m compileall -q src tests
uv run python -m omh.cli docs workflows --check
git diff --check

개발 조직

Team Art & Engineering의 일부로 공개 개발. @rlaope 팔로우.

AI 에이전트 Friren, Killua 협업. nous-research의 hermes-agent 기반.

링크

• 웹사이트: https://rlaope.github.io/oh-my-hermes/
• 문서: /docs/README.md
• GitHub Pages: /site/index.html
• 트위터/X: @rlaope