Repolode
hashgraph-online

hashgraph-online/hol-guard

AI 에이전트의 셸 명령, 파일 접근, 패키지 설치 및 MCP 도구 호출을 실행 전에 검토하는 로컬 우선 런타임 보안 계층입니다.

스타
964
포크
197
열린 이슈
112
마지막 커밋
60분 전

어떤 프로젝트인가요?

HOL Guard는 AI 코딩 에이전트와 관련 도구를 보호하는 오픈 소스 보안 계층입니다. 셸 명령, 파일 읽기, 패키지 설치, MCP 도구 호출 같은 작업을 실행 전에 검사해 비밀 정보 노출, 파괴적인 작업, 프롬프트 인젝션, 공급망 위험을 찾아냅니다. 각 결정은 로컬 정책에 따라 허용하거나 차단하거나 승인을 요청할 수 있으며, 나중에 검토할 수 있도록 영수증으로 기록됩니다.

CLI는 초기 설정과 일상적인 작업을 지원합니다. 초기화 마법사가 지원되는 에이전트를 찾아내고, `hol-guard status`와 `doctor`로 연동 상태를 확인할 수 있으며, 명령어를 통해 승인, 영수증, 아티팩트 인벤토리 및 패키지 검사를 관리할 수 있습니다. 계정 없이 실행할 수 있으며, 선택 사항인 Guard Cloud를 사용하면 기록 공유, 팀 정책, 플릿 관리 기능을 이용할 수 있습니다. 이 프로젝트에는 에이전트 플러그인, 스킬, MCP 패키지를 린트하고 검사하는 별도의 CLI인 `plugin-scanner`도 포함되어 있습니다. 이 도구는 텍스트, JSON, Markdown 또는 SARIF 형식으로 결과를 출력하며 GitHub Action도 제공합니다.

지원 에이전트에는 Codex, Claude Code, Cursor, Gemini CLI, Cline, OpenCode, OpenClaw 등이 포함됩니다. 에이전트마다 노출하는 훅 이벤트가 달라 지원 범위도 다릅니다.

핵심 기능

  • 01셸 명령, 파일 접근, 패키지 설치를 실행 전에 검토합니다.
  • 02로컬 정책에 따라 작업을 차단하거나 허용하고, 승인을 요청합니다.
  • 03결정 영수증을 기록하고 로컬 승인 대시보드를 제공합니다.
  • 04`plugin-scanner`로 에이전트 플러그인, 스킬, MCP 패키지를 검사합니다.
  • 05SARIF 보고서를 내보내고 CI 게이트용 GitHub Action을 제공합니다.

활용 사례

  • Claude Code나 Codex 같은 AI 코딩 에이전트를 실행할 때 개발자 컴퓨터를 보호합니다.
  • 에이전트 워크플로에서 MCP 서버 연결과 도구 호출을 승인 절차로 제어합니다.
  • 플러그인이나 스킬 패키지를 공개하기 전에 보안 문제를 검사합니다.
  • CI 파이프라인에 에이전트 플러그인 보안 검사를 추가합니다.

토픽

자주 묻는 질문

hol-guard은(는) 무엇인가요?
AI 에이전트의 셸 명령, 파일 접근, 패키지 설치 및 MCP 도구 호출을 실행 전에 검토하는 로컬 우선 런타임 보안 계층입니다. HOL Guard는 AI 코딩 에이전트와 관련 도구를 보호하는 오픈 소스 보안 계층입니다. 셸 명령, 파일 읽기, 패키지 설치, MCP 도구 호출 같은 작업을 실행 전에 검사해 비밀 정보 노출, 파괴적인 작업, 프롬프트 인젝션, 공급망 위험을 찾아냅니다. 각 결정은 로컬 정책에 따라 허용하거나 차단하거나 승인을 요청할 수 있으며, 나중에 검토할 수 있도록 영수증으로 기록됩니다.
hol-guard은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
hol-guard은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
hol-guard은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. hol-guard의 마지막 커밋은 2026년 10월 22일입니다.
hol-guard은(는) 어디에 사용할 수 있나요?
Claude Code나 Codex 같은 AI 코딩 에이전트를 실행할 때 개발자 컴퓨터를 보호합니다. 에이전트 워크플로에서 MCP 서버 연결과 도구 호출을 승인 절차로 제어합니다. 플러그인이나 스킬 패키지를 공개하기 전에 보안 문제를 검사합니다. CI 파이프라인에 에이전트 플러그인 보안 검사를 추가합니다.
hol-guard은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/hashgraph-online/hol-guard

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트