Repolode
Enviar
kaplanelad

kaplanelad/shellfirm

Uma camada de proteção para o shell que intercepta comandos perigosos digitados por pessoas ou agentes de programação com IA e exige confirmação antes de executá-los.

Ver no GitHubSite
Estrelas
948
Forks
33
Issues abertas
3
Último commit
há 5 meses

O que é?

shellfirm fica entre você e o shell, verificando os comandos antes da execução. Quando um comando corresponde a um dos padrões integrados — como exclusões recursivas, force pushes ou operações destrutivas no Kubernetes, Terraform, Docker ou em bancos de dados —, ele mostra o nível de gravidade, o escopo afetado e uma alternativa mais segura. Em seguida, pede que você resolva um pequeno desafio para continuar.

É compatível com Zsh, Bash, Fish, Nushell, PowerShell, Elvish, Xonsh e Oils. A proteção pode ser reforçada automaticamente em contextos de maior risco, como sessões SSH, shells de root, branches protegidas do git ou clusters de Kubernetes de produção. As equipes podem compartilhar regras por meio de um arquivo .shellfirm.yaml, e cada comando interceptado e decisão fica registrado em um log de auditoria no formato JSON Lines.

Para agentes de IA, `shellfirm connect claude-code` instala um hook que verifica os comandos Bash antes da execução e registra um servidor MCP com ferramentas para verificar e explicar comandos, além de sugerir alternativas.

Recursos principais

  • 01Detecta mais de 100 padrões de comandos arriscados relacionados a sistemas de arquivos, git, Kubernetes, Terraform, Docker, AWS, GCP/Azure, Heroku e bancos de dados.
  • 02É compatível com oito shells, incluindo Zsh, Bash, Fish, Nushell e PowerShell.
  • 03Aumenta a dificuldade dos desafios em contextos de SSH, root, branches protegidas e Kubernetes de produção.
  • 04Mostra comandos alternativos mais seguros junto com cada aviso.
  • 05Compartilha regras de segurança da equipe por meio de uma política de projeto .shellfirm.yaml, que só pode adicionar restrições.
  • 06Registra cada comando interceptado e decisão em linhas JSON.

Casos de uso

  • Proteger seu próprio terminal contra comandos destrutivos executados por acidente, como rm -rf ou force pushes.
  • Permitir que Claude Code ou outros agentes de IA executem comandos do shell com uma verificação de segurança a cada chamada Bash.
  • Aplicar regras de segurança compartilhadas ao trabalho da equipe na infraestrutura de produção.
  • Consultar o histórico de auditoria de comandos arriscados executados em um ambiente compartilhado.

Tópicos

#shell#terminal#safety#devops#cli#mcp#kubernetes#git#agent#ai

Perguntas frequentes

O que é shellfirm?
Uma camada de proteção para o shell que intercepta comandos perigosos digitados por pessoas ou agentes de programação com IA e exige confirmação antes de executá-los. shellfirm fica entre você e o shell, verificando os comandos antes da execução. Quando um comando corresponde a um dos padrões integrados — como exclusões recursivas, force pushes ou operações destrutivas no Kubernetes, Terraform, Docker ou em bancos de dados —, ele mostra o nível de gravidade, o escopo afetado e uma alternativa mais segura. Em seguida, pede que você resolva um pequeno desafio para continuar.
shellfirm é gratuito? Qual é a licença?
shellfirm é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
shellfirm ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de shellfirm foi em 15 de mai. de 2026.
Para que posso usar shellfirm?
Proteger seu próprio terminal contra comandos destrutivos executados por acidente, como rm -rf ou force pushes. Permitir que Claude Code ou outros agentes de IA executem comandos do shell com uma verificação de segurança a cada chamada Bash. Aplicar regras de segurança compartilhadas ao trabalho da equipe na infraestrutura de produção. Consultar o histórico de auditoria de comandos arriscados executados em um ambiente compartilhado.
Onde consigo shellfirm?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/kaplanelad/shellfirm

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

Projetos relacionados