Oversight (v0.5.9)

Oversight ist ein Terminal-Tool für Sicherheitsintelligenz und ein intelligenter Code-Pager, der Shell-Skripte und Paket-Upgrade-Streams prüft, bevor sie auf Ihrem System ausgeführt werden. Es schließt die Lücke zwischen blindem Vertrauen und mühsamer manueller Prüfung durch Echtzeit-Heuristik-Analyse und interaktive Überprüfung.

Oversight Demo

Highlights

Statische & heuristische Audit-Engine: Bewertet Skript-Puffer mithilfe modularer Regex-Muster und Shannon-Entropie, um obfuskierte Zeichenketten, gepackte Binärdateien und verdächtige Lifecycle-Ketten zu erkennen.
Intelligenter Pager-Fallback: Wenn ein Stream die Analyse ohne Risiko-Flags besteht, fungiert Oversight als reaktionsschneller Text-Pager mit flüssigem Zeilen-Scrolling, Seitenwechsel und Mausrad-Unterstützung.
Multi-Paket-Git-Diff-Trennung: Isoliert Batch-Upgrade-Streams dynamisch in dedizierte Paket-Tabs neben lokalen Build-Dateien wie PKGBUILD und .install-Skripten.
Live-Shell-Interception: Optionale leichtgewichtige Hooks für Zsh, Bash und Fish, die risikoreiche Befehle abfangen und vor der Ausführung eine Analyse anfordern.

Schnellinstallation

Über das Arch User Repository (AUR)

yay -S oversight-git

Aus dem Quellcode

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

Schnellstart

# 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

Paketmanager-Integration

Um Oversight als Diff-Pager während Paket-Upgrades zu verwenden, fügen Sie den Alias zu Ihrem Shell-Profil hinzu:

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

Für Paru fügen Sie diese Zeilen zu ~/.config/paru/paru.conf hinzu:

[options]
Pager = oversight
CombinedUpgrade

Referenz der wichtigsten Steuerungstasten

Taste / Eingabe	Kontext	Aktion
`↓` / `↑`	Pager-Modus / Tabs	Viewport Zeile für Zeile scrollen
`↓` / `↑`	Befunde-Ansicht	Zwischen markierten Befunden navigieren
`j` / `k`	Alle Ansichten	Viewport Zeile für Zeile scrollen
`PageDown` / `Space`	Alle Ansichten	Viewport um eine Seite nach unten scrollen
`PageUp` / `b`	Alle Ansichten	Viewport um eine Seite nach oben scrollen
`d` / `u`	Alle Ansichten	Viewport um eine halbe Seite nach unten oder oben scrollen
`Home` / `g` / `←`	Alle Ansichten	Zum Anfang des Streams springen
`End` / `G`	Alle Ansichten	Zum Ende des Streams springen
`Tab` / `0-9`	Multi-Paket	Zwischen Paket-Tabs wechseln oder zu ihnen springen
`s`	Befunde-Ansicht	Unterdrückung des ausgewählten Befunds umschalten
Mausrad	Alle Ansichten	Viewport flüssig um 3 Zeilen scrollen
`q` / `Esc`	Alle Ansichten	Oversight beenden

Vollständige Dokumentation

Für detaillierte Architektur-Anleitungen, das Erstellen eigener Signaturen (rules.json), die Konfiguration des globalen System-Pagers und Fehlerbehebung besuchen Sie die offizielle Dokumentationswebsite:

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

Community & Beiträge

Beiträge, Regel-Einreichungen und Feedback sind willkommen.

Diskutieren und stellen Sie Fragen auf Discord (Rakosn1cek Hub)
Eröffnen Sie ein Issue oder eine Diskussion auf GitHub

oversight

Beliebteste