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.

Oversight Demo

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 PKGBUILD e 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

oversight

Mais Populares