Built-in 플러그인
기준일: 2026-07-26
난이도: 중급
공식 기준: Built-in Plugins
개요
저장소에 동봉된 번들 플러그인입니다. 사용자 플러그인과 동일한 표면(hooks/tools/slash)을 쓰며, 기본 비활성(opt-in) 입니다. 일반 플러그인 개념은 Plugins 문서, 작성법은 Build a Hermes Plugin을 보세요.
핵심 개념
| 항목 | 설명 |
|---|---|
| Bundled | <repo>/plugins/<name>/ |
| User | ~/.hermes/plugins/ |
| Project | ./.hermes/plugins/ (HERMES_ENABLE_PROJECT_PLUGINS=1) |
| Pip entry points | hermes_agent.plugins |
| Override | 이후 소스 동일 이름 승 |
| memory/context_engine | 번들 스캔 제외 — 전용 provider 경로 |
상세
디스커버리 순서
- Bundled
- User
- Project (플래그 필요)
- Pip entry points
Opt-in 활성화
hermes plugins enable disk-cleanup
hermes plugins disable disk-cleanup
hermes plugins list
plugins:
enabled:
- disk-cleanup
업그레이드 시 자동 enable 되지 않습니다. 항상 명시적으로 켭니다.
현재 동봉 예
| Plugin | Kind | Purpose |
|---|---|---|
disk-cleanup |
hooks + slash | 에페메럴 파일 추적 후 세션 종료 시 정리 |
security-guidance |
hooks | write_file/patch 위험 패턴 경고·차단 (공개 패턴 계열) |
observability/langfuse |
hooks | 턴/LLM/툴 트레이스 → Langfuse |
google_meet |
연동 | Google Meet — OAuth·계정 권한, 초대 정책 주의 |
hermes-achievements |
UX | 사용 마일스톤 등 |
disk-cleanup
- 세션 중 생성한 임시 산출물 추적
- 세션 종료 훅에서 정리
- slash로 수동 관리 가능 (원문 명령 참조)
security-guidance
- 쓰기 도구 호출 시 패턴 매칭
- 경고 append 또는 block
- 규칙 수·라이선스는 원문 고지 따름
observability/langfuse
- 관측 백엔드로 트레이스 export
- API 키·호스트 env 필요
google_meet / hermes-achievements
- 회의 참가·성과 UX 등 부가 기능
- 계정 권한·정책(“초대된 참가자만”) 실패 모드 숙지
기여자: 번들 플러그인 추가
- 인트리
plugins/패턴 준수 - 기본 enable 금지
- 문서·테스트·opt-in 명시
- memory/context_engine 전용 경로와 혼동 금지
체크리스트
-
hermes plugins list로 번들 목록 확인 - 필요한 플러그인만 enable
- security-guidance 등 보안 플러그인 정책 이해
- 프로젝트 플러그인 플래그 남용 금지
다음 단계
- 공식 문서: Built-in Plugins
- Hermes 플러그인 만들기
- 트러블슈팅
기준일: 2026-07-26 — 공식 문서 동기화 코퍼스