hashgraph-online/hol-guard

HOL Guard – AI 에이전트를 위한 오픈소스 안티바이러스

개요 – Python 기반의 로컬 우선 보안 계층으로, AI 에이전트(예: Codex, Claude Code, GitHub Copilot CLI, Gemini CLI 등)가 셸 명령을 실행하거나 파일에 접근하거나 패키지를 설치하거나 외부 도구를 호출하기 전에 이를 감시합니다. 비밀 노출, 파괴적 작업, 프롬프트 인젝션 시도, 공급망 위험을 플래그하고 허용, 차단 또는 승인 요청을 할 수 있습니다.

설치

pipx install hol-guard      # 격리된 환경에 CLI 설치
hol-guard init             # 에이전트를 발견하고 보호를 구성하는 마법사 실행

버전은 hol-guard --version으로 확인할 수 있으며, hol-guard update로 업데이트할 수 있습니다.

핵심 기능

영역	HOL Guard가 수행하는 작업
셸/파일 접근	파괴적 패턴, 자격 증명 노출, 의심스러운 외부 호출을 스캔합니다.
패키지 설치	pip, npm 등을 가로채서 설치를 허용하기 전에 공급망 인텔리전스 데이터베이스와 대조합니다.
플러그인, 스킬, 에이전트 구성	로컬 플러그인을 인벤토리하고 에이전트가 실행하기 전에 새 도구나 변경된 도구를 검토합니다.
MCP 서버 및 도구	MCP 서버 구성을 검사하고 관리 후크를 통해 도구 호출을 프록시합니다.
프롬프트 및 도구 결과	프롬프트 인젝션을 감지하고 에이전트 생성 텍스트에서 민감한 콘텐츠를 필터링합니다.
승인 및 증거	위험한 작업을 기본 프롬프트 또는 대시보드로 라우팅하고 추후 감사를 위한 영수증을 기록합니다.

일반적인 워크플로우

# 현재 보호 상태 확인
hol-guard status

# 특정 에이전트 통합 진단
hol-guard doctor codex

# 실행하지 않고 발생할 일 미리 보기
hol-guard diff codex

# 대기 중인 승인 요청 처리
hol-guard approvals            # 목록 보기
hol-guard approvals approve <id>

# 결정 기록 보기
hol-guard receipts

드라이런 (hol-guard run codex --dry-run)은 에이전트를 실제로 실행하지 않고 아티팩트 상태를 기록하여 안전 검사에 유용합니다.

지원 에이전트 – Codex, Claude Code, GitHub Copilot CLI, Cursor, Cline, Gemini CLI, Grok, Hermes, Kimi Code, Pi, oh‑my‑pi, OpenClaw, OpenCode, Antigravity, ZCode, Devin, Paseo(네이티브 공급자 어댑터를 통해). README에는 자세한 지원 매트릭스에 대한 링크가 있습니다.

플러그인 스캐너 – 동일한 리포지토리에는 플러그인/스킬 작성자와 CI 파이프라인을 위한 CLI인 plugin‑scanner도 포함되어 있습니다.

• scan: 보안 문제 스캔,
• lint: 규칙 수준 작성 피드백,
• verify: 설치 시 준비 상태 검증,
• submit: 마켓플레이스 제출용 패키지 아티팩트 제출,
• doctor: 진단 정보 수집. Codex, Claude Code, DeepSeek Harness, Gemini CLI, Kimi Code, OpenCode 등 다양한 생태계를 지원하며 CI 통합을 위해 text, json, markdown, sarif 형식으로 출력합니다. 기성 GitHub Action(hashgraph-online/ai-plugin-scanner-action)을 사용하면 최소 점수로 PR을 게이트할 수 있습니다.

선택적 Guard Cloud – 승인 기록을 동기화하고 팀 전체에서 정책을 공유하며 플릿 전체 관리를 제공하는 SaaS 애드온(필수 아님)입니다.

중요성 – AI 에이전트가 임의의 명령을 실행하고 종속성을 설치할 수 있게 되면서 새로운 공격 표면이 됩니다. HOL Guard는 이러한 에이전트에게 친숙한 "안티바이러스" 경험을 제공하여 AI 강화 도구의 생산성 이점을 허용하면서도 머신을 안전하게 유지합니다.

링크

• 문서: https://github.com/hashgraph-online/hol-guard/blob/main/docs/guard/get-started.md
• PyPI 패키지: hol-guard 및 plugin-scanner
• 대시보드 및 클라우드: https://hol.org/guard/activate
• GitHub 리포지토리: https://github.com/hashgraph-online/hol-guard