O que agentguard faz?
Guarda de segurança para agentes de IA — bloqueia skills maliciosos, previne vazamentos de dados, protege segredos. 24 regras de detecção, avaliação de ações em tempo real, registro de confiança.
Descrição
O agentguard é uma skill de segurança para agentes de IA (como Claude Code, Cursor, Codex) que intercepta e avalia ações potencialmente perigosas antes de sua execução. Ele utiliza um conjunto de 24 regras de detecção para identificar comportamentos suspeitos, como acesso indevido a arquivos, chamadas de API não autorizadas, tentativas de escalonamento de privilégios e vazamento de segredos. Além disso, mantém um registro de confiança (trust registry) para skills e fontes verificadas, permitindo que apenas código confiável seja executado.
Por que usar?
- Segurança proativa: Bloqueia ações maliciosas antes que causem danos.
- Proteção de dados: Impede vazamento de informações sensíveis.
- Gerenciamento de confiança: Permite criar uma lista de skills e fontes confiáveis.
- Fácil integração: Funciona com os principais agentes de IA.
Plataformas Suportadas
- Claude Code
- Cursor
- Codex
- Outros agentes que suportam skills personalizadas
Como Funciona
- Intercepção: O agentguard monitora as ações solicitadas pelo agente de IA.
- Avaliação: Cada ação é verificada contra as 24 regras de detecção.
- Decisão: Se a ação for considerada segura, ela é executada; caso contrário, é bloqueada e um alerta é gerado.
- Registro: Ações e resultados são registrados para auditoria.
Regras de Detecção
| ID | Regra | Descrição |
|---|---|---|
| 1 | Acesso a arquivos sensíveis | Bloqueia leitura/escrita em arquivos como /etc/passwd, .env, etc. |
| 2 | Chamadas de API não autorizadas | Impede requisições a endpoints externos não confiáveis. |
| 3 | Escalonamento de privilégios | Detecta tentativas de executar comandos com sudo ou root. |
| 4 | Vazamento de segredos | Monitora saída contendo chaves de API, tokens, senhas. |
| ... | ... | ... |
Configuração
Variáveis de Ambiente
AGENTGUARD_ENABLED: Ativa ou desativa o guarda (true/false).AGENTGUARD_TRUST_REGISTRY: Caminho para o arquivo de registro de confiança.AGENTGUARD_LOG_LEVEL: Nível de log (debug, info, warn, error).
Exemplo de Uso
# Ativar o agentguard com configuração padrão
export AGENTGUARD_ENABLED=true
export AGENTGUARD_TRUST_REGISTRY=~/.agentguard/trust.json
# Executar o agente com proteção
claude-code
Registro de Confiança
O registro de confiança é um arquivo JSON que lista skills, fontes e ações permitidas. Exemplo:
{
"trusted_skills": ["skill-exemplo"],
"trusted_sources": ["github.com/exemplo"],
"allowed_actions": ["ler-arquivo", "escrever-arquivo", "chamar-api"]
}
Contribuição
Contribuições são bem-vindas! Siga as diretrizes do repositório.
Licença
MIT