navilai/navil

O que navil faz?

Segurança em tempo de execução para chamadas de ferramentas de agentes de IA. Política na instalação, aplicação a cada chamada.

---

Visão Geral

O navilai/navil fornece uma camada de segurança dinâmica para agentes de IA, interceptando e validando chamadas de ferramentas contra políticas definidas pelo desenvolvedor. Ele é projetado para ser plug-and-play, instalado como uma habilidade (skill) no ambiente do agente, e aplica regras de autorização, negação ou auditoria em cada interação com ferramentas externas.

Funcionalidades

• Políticas declarativas: Defina regras usando arquivos YAML/JSON ou variáveis de ambiente.
• Controle granular: Permite ou bloqueia ferramentas específicas, argumentos ou padrões de uso.
• Auditoria em tempo real: Registra todas as chamadas de ferramentas para análise posterior.
• Suporte multi-agente: Funciona com Claude Code, Cursor, Codex e outros agentes baseados em LLM.
• Não intrusivo: Não requer modificação no código do agente ou nas ferramentas existentes.

Como Instalar

1. Adicione a skill ao seu agente conforme a documentação da plataforma.
2. Defina as políticas em um arquivo navil-policy.yaml no diretório raiz do projeto:

policies:
  - tool: "execute_command"
    allow: false
  - tool: "read_file"
    allow: true
    args:
      path: "/app/src/*"

3. Configure a variável de ambiente NAVIL_POLICY_FILE se o arquivo tiver nome ou localização diferente.

Exemplo de Uso

# Configurar política via variável de ambiente
export NAVIL_POLICY='{"policies": [{"tool": "*", "allow": true}]}'

# Executar o agente normalmente
claude code

Plataformas Suportadas

• Claude Code
• Cursor
• Codex CLI
• Qualquer agente que suporte skills ou plugins

Considerações de Segurança

• Sempre revise as políticas antes de aplicar.
• Use allow: false como regra padrão e habilite apenas ferramentas necessárias.
• Combine com outras medidas de segurança, como sandboxing e limites de recursos.

Contribuição

Pull requests são bem-vindos. Consulte o repositório oficial para detalhes de contribuição.

Licença

MIT