Kisyntra/Agent_Sudo

O que Agent_Sudo faz?

Portal de permissões locais para agentes de IA com aprovações, delegação, registro de auditoria e integração MCP.

Visão Geral

O Kisyntra/Agent_Sudo é um gateway de permissões leve e local que fornece controle de acesso refinado para agentes de IA. Ele permite que você:

• Aprovações: Exija aprovação humana ou automatizada antes que ações críticas sejam executadas.
• Delegação: Delegue tarefas com escopos de permissão limitados.
• Registro de Auditoria: Mantenha registros detalhados de todas as ações do agente para conformidade e depuração.
• Integração MCP: Use o Model Context Protocol para solicitações de permissão padronizadas.

Como Funciona

O Agent_Sudo intercepta ações de agentes de IA e as submete a um mecanismo de política local. Dependendo da política configurada, a ação pode ser:

• Aprovada automaticamente
• Bloqueada automaticamente
• Enviada para aprovação humana via CLI ou interface web
• Registrada para auditoria posterior

Isso é especialmente útil para ambientes de produção onde a segurança do agente é fundamental, como em pipelines de CI/CD, ferramentas de desenvolvimento ou automação pessoal.

Plataformas Suportadas

• Claude Code
• Cursor
• Codex (OpenAI)
• Qualquer agente compatível com MCP

Instalação

npm install -g agent-sudo
# ou
npx kisyntra/agent-sudo

Uso Básico

1. Inicie o gateway:

   agent-sudo start
   

2. Configure regras de permissão em ~/.config/agent-sudo/policies.yaml:

   policies:
     - action: "file:write"
       require: approval
     - action: "network:request"
       require: always_block
     - action: "command:run"
       require: always_log
   

3. Conecte seu agente de IA ao gateway:

   export AGENT_SUDO_ENDPOINT=http://localhost:3000
   

4. Execute ações como de costume — o gateway gerenciará permissões automaticamente.

Exemplo de Fluxo de Trabalho

1. Agente tenta ler um arquivo sensível
2. Gateway verifica política → 'require: approval'
3. Usuário recebe notificação: "O agente deseja ler /etc/shadow. Aprovar? (s/N)"
4. Se aprovado, ação é executada e registrada; caso contrário, bloqueada

Documentação Adicional

Para documentação completa, visite kisyntra.com/agent-sudo ou consulte o repositório GitHub.

Licença

MIT