Oversight (v0.5.9)

Oversight es una herramienta de inteligencia de seguridad para terminal y un paginador de código inteligente diseñado para auditar scripts de shell y flujos de actualización de paquetes antes de que se ejecuten en tu sistema. Tiende un puente entre la confianza ciega y la tediosa auditoría manual mediante análisis heurístico en tiempo real y revisión interactiva.

Oversight Demo

Aspectos destacados

Motor de auditoría estático y heurístico: Evalúa búferes de scripts usando patrones regex modulares y entropía de Shannon para detectar cadenas ofuscadas, binarios empaquetados y cadenas de ciclo de vida sospechosas.
Paginador inteligente de reserva: Cuando un flujo supera el análisis sin marcas de riesgo, Oversight funciona como un paginador de texto ágil con desplazamiento fluido por líneas, avance por páginas y soporte para la rueda del ratón.
Separación de git diff multipaquete: Aísla dinámicamente los flujos de actualización por lotes en pestañas dedicadas por paquete, junto con archivos de compilación locales como PKGBUILD y scripts .install.
Intercepción de shell en vivo: Hooks ligeros opcionales para Zsh, Bash y Fish que interceptan comandos de alto riesgo y solicitan un análisis antes de la ejecución.

Instalación rápida

Mediante Arch User Repository (AUR)

yay -S oversight-git

Desde el código fuente

git clone https://github.com/Rakosn1cek/oversight.git
cd oversight
chmod +x install.sh
./install.sh

Inicio 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

Integración con el gestor de paquetes

Para usar Oversight como tu paginador de diff durante las actualizaciones de paquetes, añade el alias a tu perfil de shell:

# For Yay (~/.zshrc or ~/.bashrc)
alias yay="yay --diffpager oversight"

Para Paru, añade estas líneas a ~/.config/paru/paru.conf:

[options]
Pager = oversight
CombinedUpgrade

Referencia de controles principales

Tecla / Entrada	Contexto	Acción
`↓` / `↑`	Modo paginador / Pestañas	Desplaza la vista línea por línea
`↓` / `↑`	Vista de hallazgos	Navega entre los hallazgos marcados
`j` / `k`	Todas las vistas	Desplaza la vista línea por línea
`PageDown` / `Space`	Todas las vistas	Desplaza la vista hacia abajo una página
`PageUp` / `b`	Todas las vistas	Desplaza la vista hacia arriba una página
`d` / `u`	Todas las vistas	Desplaza la vista hacia abajo o arriba media página
`Home` / `g` / `←`	Todas las vistas	Salta al inicio del flujo
`End` / `G`	Todas las vistas	Salta al final del flujo
`Tab` / `0-9`	Multipaquete	Recorre o salta a las pestañas de paquetes
`s`	Vista de hallazgos	Activa o desactiva la supresión del hallazgo seleccionado
Rueda del ratón	Todas las vistas	Desplaza la vista suavemente 3 líneas
`q` / `Esc`	Todas las vistas	Sale de Oversight

Documentación completa

Para guías detalladas de arquitectura, creación de firmas personalizadas (rules.json), configuración global del paginador del sistema y resolución de problemas, visita el sitio web de documentación oficial:

👉 https://rakosn1cek.github.io/oversight/

Comunidad y contribuciones

Las contribuciones, el envío de reglas y los comentarios son bienvenidos.

Debate y formula preguntas en Discord (Rakosn1cek Hub)
Abre un issue o una discusión en GitHub

oversight

Más Populares