Repolode
Enviar
LuD1161

LuD1161/agentjail

Barreiras de segurança para agentes de programação como Claude Code, Codex e Cursor, que verificam cada chamada de ferramenta localmente antes da execução.

Ver no GitHubSite
Estrelas
100
Forks
8
Issues abertas
2
Último commit
mês passado

O que é?

O AgentJail é uma camada de segurança para agentes de programação como Claude Code, Codex e Cursor. Após a instalação, ele registra hooks em cada agente compatível, para que toda chamada de ferramenta (comandos de shell, leitura e edição de arquivos, chamadas MCP) seja avaliada com base em regras OPA Rego antes de ser executada. As decisões podem ser permitir, perguntar ou negar, e um daemon local persistente com cache de decisões mantém a verificação rápida.

Os hooks, por si só, são verificações cooperativas. Iniciar um agente com `agentjail run` adiciona um sandbox no nível do sistema operacional, que restringe o acesso ao sistema de arquivos independentemente do daemon de hooks. Entre os recursos opcionais estão uma lista de permissões de rede com negação por padrão, um broker de credenciais que entrega à sessão apenas secrets selecionados explicitamente, uma interface web local e a reprodução das decisões no terminal, além de relatórios de custos locais com base nas transcrições do Claude Code, Codex e OpenCode. O projeto é compatível com macOS e Linux e foi desenvolvido em Go.

Recursos principais

  • 01Verifica cada chamada de ferramenta do agente com base em políticas OPA Rego antes da execução
  • 02Retorna decisões de permitir, perguntar ou negar, acompanhadas de explicações
  • 03Adiciona um sandbox no nível do sistema operacional para restringir o acesso ao sistema de arquivos usando `agentjail run`
  • 04Lista de permissões de rede com negação por padrão e visibilidade opcional do tráfego
  • 05Broker de credenciais que entrega à sessão apenas secrets selecionados explicitamente
  • 06Visualizador local de reprodução, painel no terminal e relatórios de custos

Casos de uso

  • Impedir que um agente de programação execute comandos destrutivos, como force-pushes ou exclusões recursivas
  • Evitar o vazamento acidental de arquivos .env ou credenciais de nuvem para o contexto de um agente
  • Limitar os hosts para os quais um agente pode enviar dados durante uma sessão
  • Revisar o que um agente fez e por quê por meio da reprodução da sessão

Início rápido

  1. 1

    Instale o minisign primeiro (macOS)

    brew install minisign
  2. 2

    Instale o AgentJail via Homebrew

    brew install LuD1161/tap/agentjail
  3. 3

    Verifique o status da proteção

    agentjail doctor
  4. 4

    Inicie seu agente pelo AgentJail com o sandbox do sistema operacional

    agentjail run -- codex

Antes de usar

  • Compatível apenas com macOS e Linux.
  • Os hooks, por si só, fazem verificações cooperativas e não criam uma barreira de isolamento do sistema de arquivos; para usar o sandbox do sistema operacional, é necessário iniciar pelo comando agentjail run.
  • Algumas proteções dependem da disponibilidade do daemon e da cobertura do sandbox na plataforma.

Em coleções

Ferramentas, skills e plugins para Claude CodeFrameworks e apps de agentes de IA open sourceAssistentes e agentes de programação com IA

Tópicos

#agent-security#guardrails#policy-as-code#sandbox#claude-code#codex#cursor#opa#ai-agents#devsecops

Perguntas frequentes

O que é agentjail?
Barreiras de segurança para agentes de programação como Claude Code, Codex e Cursor, que verificam cada chamada de ferramenta localmente antes da execução. O AgentJail é uma camada de segurança para agentes de programação como Claude Code, Codex e Cursor. Após a instalação, ele registra hooks em cada agente compatível, para que toda chamada de ferramenta (comandos de shell, leitura e edição de arquivos, chamadas MCP) seja avaliada com base em regras OPA Rego antes de ser executada. As decisões podem ser permitir, perguntar ou negar, e um daemon local persistente com cache de decisões mantém a verificação rápida.
agentjail é gratuito? Qual é a licença?
agentjail é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
agentjail ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de agentjail foi em 24 de set. de 2026.
Para que posso usar agentjail?
Impedir que um agente de programação execute comandos destrutivos, como force-pushes ou exclusões recursivas Evitar o vazamento acidental de arquivos .env ou credenciais de nuvem para o contexto de um agente Limitar os hosts para os quais um agente pode enviar dados durante uma sessão Revisar o que um agente fez e por quê por meio da reprodução da sessão
Como instalar agentjail?
Instale o minisign primeiro (macOS): brew install minisign Instale o AgentJail via Homebrew: brew install LuD1161/tap/agentjail Verifique o status da proteção: agentjail doctor Inicie seu agente pelo AgentJail com o sandbox do sistema operacional: agentjail run -- codex
Onde consigo agentjail?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/LuD1161/agentjail

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

Projetos relacionados