Repolode
hashgraph-online

hashgraph-online/hol-guard

Camada de segurança local-first em tempo de execução que analisa comandos de shell, acesso a arquivos, instalação de pacotes e chamadas de ferramentas MCP de agentes de IA antes da execução.

Estrelas
964
Forks
197
Issues abertas
112
Último commit
há 59 minutos

O que é?

HOL Guard é uma camada de proteção open source para agentes de programação com IA e suas ferramentas. Ela verifica ações como comandos de shell, leitura de arquivos, instalação de pacotes e chamadas de ferramentas MCP antes da execução, procurando exposição de segredos, operações destrutivas, prompt injection e riscos na cadeia de suprimentos. Cada decisão pode permitir, bloquear ou solicitar aprovação conforme uma política local, e fica registrada em um recibo para análise posterior.

A CLI cuida da configuração e das tarefas do dia a dia: um assistente de inicialização detecta os agentes compatíveis, `hol-guard status` e `doctor` verificam as integrações, e comandos gerenciam aprovações, recibos, um inventário de artefatos e a verificação de pacotes. O projeto funciona sem uma conta; o Guard Cloud, opcional, adiciona histórico compartilhado, políticas para equipes e gerenciamento de frotas. O projeto também inclui `plugin-scanner`, uma CLI separada que analisa e verifica plugins de agentes, skills e pacotes MCP, gera saídas em texto, JSON, Markdown ou SARIF e inclui uma GitHub Action.

Entre os agentes compatíveis estão Codex, Claude Code, Cursor, Gemini CLI, Cline, OpenCode e OpenClaw, entre outros. A cobertura varia conforme o agente, dependendo dos eventos de hook que cada um expõe.

Recursos principais

  • 01Analisa comandos de shell, acesso a arquivos e instalação de pacotes antes da execução.
  • 02Bloqueia, permite ou solicita aprovação conforme uma política local.
  • 03Registra recibos das decisões e oferece um painel local de aprovações.
  • 04Verifica plugins de agentes, skills e pacotes MCP com o plugin-scanner.
  • 05Exporta relatórios SARIF e oferece uma GitHub Action para criar gates de CI.

Casos de uso

  • Proteger a máquina de desenvolvimento ao executar agentes de programação com IA, como Claude Code ou Codex.
  • Controlar conexões com servidores MCP e chamadas de ferramentas em fluxos de trabalho com agentes.
  • Verificar plugins ou pacotes de skills em busca de problemas de segurança antes de publicá-los.
  • Adicionar verificações de segurança para plugins de agentes a um pipeline de CI.

Tópicos

Perguntas frequentes

O que é hol-guard?
Camada de segurança local-first em tempo de execução que analisa comandos de shell, acesso a arquivos, instalação de pacotes e chamadas de ferramentas MCP de agentes de IA antes da execução. HOL Guard é uma camada de proteção open source para agentes de programação com IA e suas ferramentas. Ela verifica ações como comandos de shell, leitura de arquivos, instalação de pacotes e chamadas de ferramentas MCP antes da execução, procurando exposição de segredos, operações destrutivas, prompt injection e riscos na cadeia de suprimentos. Cada decisão pode permitir, bloquear ou solicitar aprovação conforme uma política local, e fica registrada em um recibo para análise posterior.
hol-guard é gratuito? Qual é a licença?
hol-guard é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
hol-guard ainda é mantido?
Manutenção ativa. O último commit de hol-guard foi em 22 de out. de 2026.
Para que posso usar hol-guard?
Proteger a máquina de desenvolvimento ao executar agentes de programação com IA, como Claude Code ou Codex. Controlar conexões com servidores MCP e chamadas de ferramentas em fluxos de trabalho com agentes. Verificar plugins ou pacotes de skills em busca de problemas de segurança antes de publicá-los. Adicionar verificações de segurança para plugins de agentes a um pipeline de CI.
Onde consigo hol-guard?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/hashgraph-online/hol-guard

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados