oversight v0.5.8
Um auditor de segurança leve e sandbox para scripts de shell. O Oversight combina um mecanismo de Análise Estática (Rust) com Execução Dinâmica (Linux Landlock) para manter seu sistema seguro contra scripts maliciosos.
Oversight (v0.5.9)
Oversight é uma ferramenta de inteligência de segurança para terminal e um paginador de código inteligente, projetada para auditar scripts de shell e fluxos de atualização de pacotes antes que eles sejam executados no seu sistema. Ela preenche a lacuna entre a confiança cega e a auditoria manual tediosa, com análise heurística em tempo real e revisão interativa.
Destaques
- Mecanismo de Auditoria Estática e Heurística: Avalia buffers de scripts usando padrões regex modulares e entropia de Shannon para detectar strings ofuscadas, binários empacotados e cadeias de ciclo de vida suspeitas.
- Fallback de Paginador Inteligente: Quando um fluxo passa pela análise sem nenhum sinalizador de risco, o Oversight funciona como um paginador de texto responsivo, com rolagem suave por linha, avanço por página e suporte a roda do mouse.
- Separação de Git Diff Multi-Pacote: Isola dinamicamente fluxos de atualização em lote em abas dedicadas por pacote, juntamente com arquivos de build locais, como
PKGBUILDe scripts.install. - Interceptação de Shell em Tempo Real: Hooks leves opcionais para Zsh, Bash e Fish que interceptam comandos de alto risco e solicitam análise antes da execução.
Instalação Rápida
Via Arch User Repository (AUR)
yay -S oversight-git
A Partir do Código-Fonte
git clone https://github.com/Rakosn1cek/oversight.git
cd oversight
chmod +x install.sh
./install.sh
Início Rápido
# Audit a local shell script
oversight ./install.sh
# Audit a remote script safely in memory
oversight https://raw.githubusercontent.com/example/repo/main/install.sh
# Pipe git diffs or manual pages directly
git diff | oversight
Integração com Gerenciador de Pacotes
Para usar o Oversight como seu paginador de diff durante atualizações de pacotes, adicione o alias ao perfil do seu shell:
# For Yay (~/.zshrc or ~/.bashrc)
alias yay="yay --diffpager oversight"
Para o Paru, adicione estas linhas ao ~/.config/paru/paru.conf:
[options]
Pager = oversight
CombinedUpgrade
Referência de Controles Principais
| Tecla / Entrada | Contexto | Ação |
|---|---|---|
↓ / ↑ | Modo Paginador / Abas | Rola a viewport linha por linha |
↓ / ↑ | Visualização de Achados | Navega entre os achados sinalizados |
j / k | Todas as Visualizações | Rola a viewport linha por linha |
PageDown / Space | Todas as Visualizações | Rola a viewport uma página para baixo |
PageUp / b | Todas as Visualizações | Rola a viewport uma página para cima |
d / u | Todas as Visualizações | Rola a viewport meia página para baixo ou para cima |
Home / g / ← | Todas as Visualizações | Salta para o topo do fluxo |
End / G | Todas as Visualizações | Salta para o final do fluxo |
Tab / 0-9 | Multi-Pacote | Alterna ou salta para abas de pacotes |
s | Visualização de Achados | Alterna a supressão do achado selecionado |
| Roda do Mouse | Todas as Visualizações | Rola a viewport suavemente em 3 linhas |
q / Esc | Todas as Visualizações | Sai do Oversight |
Documentação Completa
Para guias detalhados de arquitetura, criação de assinaturas personalizadas (rules.json), configuração global do paginador do sistema e solução de problemas, visite o site oficial da documentação:
👉 https://rakosn1cek.github.io/oversight/
Comunidade e Contribuições
Contribuições, envio de regras e feedback são bem-vindos.
- Discuta e faça perguntas no Discord (Rakosn1cek Hub)
- Abra uma issue ou discussão no GitHub
Licença
MIT © 2026 Rakosn1cek. A atribuição é obrigatória para qualquer redistribuição ou trabalho derivado.