メインコンテンツまでスキップ

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 で終了します
4TinyShield PRO が必要です
69TinyShield に接続できません。サーバーがオフになっているか、TinyShield がインストールされていないか、起動していません(--no-launch の場合)

コマンドラインから行った決定は、TinyShield の Decisions の一覧に Command Line と表示されます。