TinyShield のコマンドラインツール (tinyshield-cli)
tinyshield-cli を使うと、ターミナルや自作のスクリプトから TinyShield を操作できます。MCP サーバーと同じツールを使えます。たとえば、ビルドスクリプトで実行するツールを承認したり、cron ジョブでルールを書き出したりできます。
コマンドラインは TinyShield PRO の機能です。TinyShield › Settings › MCP で、MCP サーバーと一緒にオンにします。
1. セットアップ
ツールはアプリの中にあります。
"/Applications/Tiny Shield.app/Contents/MacOS/tinyshield-cli" --help
Settings › MCP に表示されているエイリアスを、シェルのプロファイル(~/.zshrc)に追加します。
alias tinyshield='"/Applications/Tiny Shield.app/Contents/MacOS/tinyshield-cli"'
Setapp 版では、代わりに /Applications/Setapp/Tiny Shield.app を使ってください。TinyShield が起動していない場合は、コマンドが先にバックグラウンドで TinyShield を開きます。
2. コマンド
| コマンド | 内容 |
|---|---|
tinyshield status | バージョン、ライセンス、接続モード、Network Extension、ルールの数 |
tinyshield mode [allow-all|require-approval|block-all] | 接続モードを表示、または切り替え |
tinyshield pending list | 承認待ちのアプリと、その接続先 |
tinyshield pending allow <app>… / block <app>… | 承認待ちのアプリを名前、バンドル ID、パス、pid、ID で許可またはブロック(すべてなら --all) |
tinyshield pending wait [--timeout 60] | アプリが承認待ちになるまで待機 |
tinyshield decisions [list|allow|block|remove] | Require Approval モードの App Connection Decisions |
tinyshield block-list [list|add|remove|enable|disable] | Block List |
tinyshield allow-list [list|add|remove] | Allow List |
tinyshield apps [--range 1h] [--status blocked] | ネットワークを使ったアプリ |
tinyshield app <app> または --pid <pid> | 1 つのアプリの署名、ルール、アクティビティ、帯域幅 |
tinyshield connections <app> または --pid <pid> | アプリが接続したドメインと IP アドレス |
tinyshield domain <domain> / tinyshield ip <ip> | ドメインや IP に接続したアプリと、一致するルール |
tinyshield tree | メインウインドウの一覧をツリーで表示 |
tinyshield countries | アプリが接続した国(マップと同じ内容) |
tinyshield recently-blocked [--clear] | 最近ブロックされた接続 |
tinyshield bandwidth [--timeframe day] [--app Safari] / tinyshield live | データ使用量と現在の速度 |
tinyshield settings [get|set <setting> on|off] | block-list、dns、apple-programs、launch-at-login などの設定 |
tinyshield export <file> / tinyshield import <file> [--replace] | 構成を保存、または読み込み |
tinyshield open <window> [--search text] | main、block_list、mcp_settings などの TinyShield のウインドウを表示 |
tinyshield clear-activity --yes | 記録されたネットワークアクティビティを削除(ルールは残ります) |
tinyshield tools / tinyshield call <tool> '<json>' | すべてのツールを一覧表示、または JSON の引数でツールを呼び出し |
すべてのオプションは tinyshield <command> --help で確認できます。
block-list add と allow-list add では、/、~、./ で始まる値はアプリまたは実行ファイルとして扱われます。それ以外の値は、ドメイン、ワイルドカード(*.example.com)、IP アドレスとして扱われます。
3. 例
ビルドで使うパッケージマネージャを承認してから、ビルドを実行します。
tinyshield pending allow ~/.local/bin/uv
uv pip install -r requirements.txt
長時間の無人ジョブの前に、使うツールを承認しておきます。
tinyshield allow-list add /opt/homebrew/bin/node ~/.local/bin/uv
アプリが承認待ちになったら通知します。
if tinyshield pending wait --timeout 600 --only-new; then
osascript -e 'display notification "An app is waiting for approval" with title "TinyShield"'
fi
トラッカーをすべてのアプリでブロックし、どのアプリが接続していたかを確認します。
tinyshield block-list add '*.doubleclick.net'
tinyshield domain doubleclick.net --subdomains --range 7d
4. スクリプトでの利用
- 機械で読み取れる出力にするには、コマンドに
--jsonを付けます。 - TinyShield を開かずにエラーで終了させるには、
--no-launchを付けます。 - 終了コード:
| コード | 意味 |
|---|---|
0 | 成功 |
1 | コマンドが失敗しました。pending wait は、TinyShield が Require Approval モードでない場合にも 1 で終了します |
3 | 見つかりません。pending wait は、タイムアウトまでに承認待ちのアプリがなかった場合にも 3 で終了します |
4 | TinyShield PRO が必要です |
69 | TinyShield に接続できません。サーバーがオフになっているか、TinyShield がインストールされていないか、起動していません(--no-launch の場合) |
コマンドラインから行った決定は、TinyShield の Decisions の一覧に Command Line と表示されます。