Open-source antivirus and firewall for AI agents: block risky tools, secret access, prompt injection, malicious packages, MCP servers, plugins, and skills at runtime.
 | 위험한 AI 작업이 여러분의 머신을 손상시키기 전에 중단하세요. HOL Guard는 AI 에이전트, 도구, 플러그인, 스킬, MCP 서버, 패키지 설치를 위한 로컬 우선 보안 계층입니다. HOL Guard 설치 문서 읽기 PyPI 패키지 ( hol-guard)이슈 보고 |
|---|
HOL Guard는 에이전트 작업이 실행되기 전에 검토합니다: 셸 명령, 파일 접근, 패키지 설치, MCP 도구 호출 등입니다. 비밀 정보 노출, 파괴적 작업, 프롬프트 인젝션, 공급망 위험을 탐지한 뒤 정책에 따라 허용, 차단 또는 승인 요청을 수행합니다.
계정 없이 로컬에서 실행할 수 있습니다. CLI와 로컬 대시보드를 사용해 보호를 관리하고, 승인을 처리하며, 결정 이력을 검사하세요. 선택 사항인 Guard Cloud는 공유 이력, 팀 정책, 플릿 관리를 추가합니다.
시작하기 · 지원 에이전트 · 플러그인 스캐너 · 문서 · 확장 기여하기 · 어댑터 기여하기 · 개발
Python 3.10 이상, pipx, 그리고 일치하는 네이티브 런타임이 필요합니다. 설치 전에 플랫폼 지원 및 Windows ARM64 설정 안내를 확인하세요.
pipx install hol-guard
hol-guard init
첫 실행 마법사는 지원되는 에이전트를 탐지하고 보호 설정 과정을 안내합니다. 대시보드 열기, 에이전트 통합 설치, 선택적 클라우드 서비스 연결을 포함한 각 설정 변경 전에 확인을 요청합니다.
설치를 확인하세요:
hol-guard --version
hol-guard status
기존 설치를 업데이트하려면:
hol-guard update
수동 설정은 설치 가이드를 참조하세요. 업그레이드 관련 맥락이 담긴 주석이 달린 릴리스 노트는 hol.org/guard/releases에서 확인할 수 있으며, 원본 릴리스와 사전 릴리스는 GitHub 릴리스 페이지에 있습니다.
| 표면 | 보호 |
|---|---|
| 셸 명령 및 파일 접근 | 파괴적인 작업, 민감한 파일 접근, 자격 증명 노출, 의심스러운 아웃바운드 명령을 검토합니다. |
| 패키지 설치 | 설치 전에 지원되는 패키지 관리자 작업을 공급망 인텔리전스와 대조하여 평가합니다. |
| 플러그인, 스킬 및 에이전트 구성 | 로컬 아티팩트를 인벤토리화하고 실행 전에 신규 또는 변경된 도구를 검토합니다. |
| MCP 서버 및 도구 | 서버 구성을 검사하고 지원되는 훅과 관리형 프록시를 통해 도구 호출을 검토합니다. |
| 프롬프트 및 도구 결과 | 지원되는 이벤트에서 프롬프트 인젝션과 민감한 콘텐츠를 검사합니다. |
| 승인 및 증거 | 결정을 네이티브 프롬프트 또는 승인 센터로 라우팅하고, 검토용 로컬 영수증을 기록합니다. |
Guard는 네이티브 에이전트 훅, 관리형 MCP 프록시, 실행 통합을 통해 연결됩니다. 적용 범위는 각 에이전트가 노출하는 이벤트에 따라 달라지며, 지원 매트릭스에 통합별 적용, 승인 전달, 실패 동작이 문서화되어 있습니다.
Codex, Claude Code, GitHub Copilot CLI, Cursor, Cline, Gemini CLI, Grok, Hermes, Kimi Code, Pi, oh-my-pi, OpenClaw, OpenCode, Antigravity, ZCode, Devin. Paseo는 이러한 네이티브 제공자 통합을 통해 지원되며, 제공자별 적용 범위가 있습니다.
예를 들어 Codex를 명시적으로 설정하려면:
hol-guard install codex
hol-guard run codex --dry-run
hol-guard run codex
드라이 런은 실행 전에 현재 아티팩트 상태를 기록합니다. Codex의 경우 Guard는 네이티브 pre-tool 훅을 설치하며, 해당 훅이 없거나 비활성화된 경우 관리형 실행을 거부합니다.
| 작업 | 명령 |
|---|---|
| 보호 상태 확인 | hol-guard status |
| 에이전트 통합 진단 | hol-guard doctor codex |
| 실행 전 변경 사항 검사 | hol-guard diff codex |
| 대기 중인 승인 검토 | hol-guard approvals |
| 요청 승인 또는 거부 | hol-guard approvals approve <request-id> / hol-guard approvals deny <request-id> |
| 결정 이력 조회 | hol-guard receipts |
| 추적 중인 아티팩트 목록 | hol-guard inventory |
| AI 자재 명세서 내보내기 | hol-guard abom --format json |
| 워크스페이스 의존성 스캔 | hol-guard supply-chain scan |
| 선택적 클라우드 동기화 연결 | hol-guard connect |
명령의 분류 및 일치 규칙을 검사합니다:
hol-guard command test 'rm -rf ./build'
hol-guard command explain 'git clean -ndx'
hol-guard command extensions command.git --json
command test와 command explain은 명령을 실행하거나 승인을 생성하지 않고 명령을 검사합니다. hol-guard approvals를 사용하여 대기 중인 요청을 처리하고, hol-guard receipts를 사용하여 기록된 결정을 검토하세요.
Extension directory는 Rust로 컴파일된 카탈로그에서 생성된 명령 커버리지를 나열합니다. 외부 기여는 명시적 옵트인이 필요하며, 필수 핵심 보호 기능은 계속 활성화됩니다. 커버리지를 추가하려면 Extension contribution guide를 따르세요.
hol-guard supply-chain sync
hol-guard supply-chain scan
hol-guard supply-chain explain [email protected] --ecosystem npm
패키지 판정에는 사용 가능한 권고 증거와 생태계 커버리지가 포함됩니다. 패키지 관리자 가로채기에 대해서는 시작 가이드를, 오탐 처리에 대해서는 교정 가이드를 참조하세요.
이 저장소는 에이전트 플러그인, 스킬, MCP 통합을 게시하기 전에 보안 및 품질 검사를 수행하려는 유지관리자를 위한 CLI인 plugin-scanner도 제공합니다.
pipx install plugin-scanner
plugin-scanner scan .
plugin-scanner lint .
plugin-scanner verify .
| 명령 | 목적 |
|---|---|
scan | 감지된 패키지 표면 전반에 걸친 보안 발견 사항 및 품질 보고서. |
lint | 규칙 수준의 작성 피드백. |
verify | 설치 표면 및 런타임 준비 상태 검사. |
submit | 단일 플러그인 패키지에 대한 제출 아티팩트. |
doctor | 컴포넌트 진단 및 문제 해결 번들. |