oversight v0.5.8
Un auditor de seguridad y sandbox ligero para scripts de shell. Oversight combina un motor de Análisis Estático (Rust) con Aplicación Dinámica (Linux Landlock) para mantener tu sistema a salvo de scripts maliciosos.
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.
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
PKGBUILDy 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
Licencia
MIT © 2026 Rakosn1cek. Se requiere atribución para cualquier redistribución u obra derivada.