CLIリファレンス

すべてのkilobatコマンド、JSON出力、スクリプト。

コマンド

モニタ

kilobat status [--watch] [--json]アプリごとのライブ通信とセッションの予算。JSONスナップショット、または--watchでJSON Linesのストリーム
kilobat report [--csv|--json] [--summary] [--days 1…365]ローカルに記録された使用履歴、または日別の合計と上位アプリ。CSVはアプリごとに1行
kilobat report compare --total 40GB [--unit GB|GiB] [--direction both|download|upload] (--from DATE --to DATE | --period last-month) [--network NAME] [--json|--csv]ルーターやプロバイダの数値を、このMacでKilobatが同じ期間・同じ単位で記録した値と並べて表示。記録した時間、すべての空白期間、差が出たおもな理由も示します
kilobat health-history [--hours 1…720] [--json]アプリが記録したルーター、インターネット、ジッター、DNSの確認結果の推移
kilobat proxy [routes [--app name] | test] [--json]プロキシアプリ、システムプロキシとその問題、各アプリが通ったルールとノード、各ノードの応答速度
kilobat vpn [--json]VPN、DNSやIPv6がVPNを経由していないかどうか、VPNキルスイッチの状態
kilobat vpn leaks [--json]リークテスト:DNS、IPv6、UDP(WebRTCが使うもの)がVPNを迂回していないかを調べ、それぞれ修正する設定を示します。bash.ws、Cloudflare、STUNサーバに問い合わせます
kilobat calls [--limit 1…200] [--json]通話ごとに、フリーズした回数とその原因(アプリが作成したレポートから)
kilobat remote [--limit 1…200] [--kind ssh|mosh|desktop] [--json]SSH、Mosh、リモートデスクトップのセッションごとに、入力が遅れたり画面がフリーズしたりした理由と、Moshが役立つかどうか
kilobat stream [status|check|reports] [--json]ローカルWebSocket経由のOBS:配信中か、フレームが落ちているか、ビットレートに30%を加えた値とアップロード速度を比べる配信前チェック(check [--bitrate <kbps>] [--measure|--no-measure])、各配信後のレポート(reports [--limit 1…200])
kilobat cloud-gaming [status|reports] [--limit 1…200] [--json]GeForce NOW、Xbox Cloud Gaming、Boosteroid、Amazon Luna、Shadow:現在のセッション(ping、ジッター、パケットロス、ビットレート、データ量、問題の原因)と、各セッション後のカクつきの時刻と原因を示すレポート
kilobat overlay [--port 7171] [--target internet|router|cs2:fra|host]OBSなどの配信アプリ向けのライブpingオーバーレイ。Ctrl-Cまでlocalhostで配信します。cs2:fraのようなゲームのリージョンを指定すると、そのデータセンターにpingを送ります
kilobat support-report [--hours 1…168] [--host h] [--include-sites] [--markdown|--html] [--output f]プロバイダやITヘルプデスク向けのレポート:検出結果、遅延、通信障害、速度テスト。ネットワーク名やローカルアドレスは含みません
kilobat plan [--days 7…90] [--json]ネットワークごとに契約プランと比べた速度テスト:中央値、夜間とそのほかの時間帯の比較、半分未満だった頻度
kilobat credit [--provider id] [--price n] [--month this|last|YYYY-MM] [--draft] [--json]その月のルーターより先の障害を、プロバイダが公開している補償ルールと照らし合わせ、対象となりうる補償と申請文の下書きを表示します。<code>credit providers</code>でルールの一覧を表示
kilobat week [--weeks-ago 0…12] [--json]週間ダイジェスト:先週の主な障害、フリーズした通話、ルーター、ブロック、従量制ネットワークでのデータ量を、前の週と比べて表示
kilobat router [--all] [--json]ルーターの診断:通常の応答、ロス、切断と直近3日間の比較、再起動とその効果。アプリが保存しているチェックから表示します
kilobat router connect [fritzbox|unifi|mikrotik|openwrt] [--json]アプリのProルーター接続の設定手順。コマンドラインで認証情報を受け取ることはありません
kilobat router devices [--json]接続済みルーターのクライアント、測定速度、今日の合計をアプリ経由で表示。FRITZ!Boxなど家全体のカウンタから個別デバイスの割合を推定することはなく、クライアントカウンタにはLAN内の通信が含まれる場合があります
kilobat router disconnect [--json]このネットワークのルーターを削除します。アプリはキーチェーンの認証情報を削除するか、次回の起動時に削除します
kilobat service-speed [--all] [--test <service>] [--list] [--json]GitHub、iCloud、Steam、npmなどからのダウンロードを回線と比較し、プロバイダから各サービスへの経路が遅いときに表示。<code>--test</code>で今すぐ1つのサービスから最大25 MBをダウンロード
kilobat hotspot [--all] [--carrier <id>] [--detect] [--json]スマートフォンのテザリングで、すべてのダウンロードが通信事業者のテザリング上限で頭打ちになるか、その根拠となる測定値、事業者の公表ルールを表示。<code>hotspot carriers</code>で一覧を表示します
kilobat networks [forget <name>]これまでに接続したネットワークと、それぞれに記憶したプロファイル、予算、データ料金
kilobat networks cost <metered|unmetered|automatic> [name]現在のネットワーク、または指定したネットワークを従量制または定額として扱うか、macOSの判定に戻します
kilobat bandwidth [app] [hour|day|week|month] [--back N] [--json]1つのアプリの送受信バイト数を時間・日・週・月単位で表示し、ピークも示します。--backで以前の期間にさかのぼります
kilobat access-policy <bundle-id> [--json]アプリの開発元がInternet Access Policyで宣言している接続とその理由

診断

kilobat diagnose [--json]Wi-Fi、ルーター、インターネット、DNS、キャプティブポータルの確認とアドバイス
kilobat radar [--watch] [--json]信号スコアと最適な場所の探索
kilobat scan [--json]近くのネットワーク、チャンネル、幅、セキュリティ
kilobat channels [--json]チャンネルごとの混雑度と、最も空いているチャンネル
kilobat speedtest [--json] [--budget-mb 1…80] [--parallel]Cloudflareでの速度、負荷時の遅延、通話とストリーミングの判定。最大80 MB。デフォルトは1接続で、--parallelを付けると多くの速度測定サイトと同じく4接続を使います
kilobat speed-compare [<test> <test>] [--json]保存した2つの速度テストの違い:ネットワーク、時刻、サーバ、接続数、Wi-Fiの帯域と信号、VPN、ほかの通信
kilobat ip [--public] [--json]通信の出口:インターフェイスとVPNの有無をこのMac上で読み取ります。--publicを付けるとCloudflareにパブリックIPとその登録国も問い合わせます
kilobat portal [open] [--json]Wi-Fiのサインインページ:今すぐチェック(オープン、サインインページ、オフラインのいずれか。ページのアドレス付きで、クエリの値は伏せます)、このネットワークがサインインを求めているか、ログアウトされたか、残り時間、各ネットワークの通常のサインイン時間を表示します。openでページをブラウザで開きます
kilobat stutter [--seconds 10…60] [--target router|internet|<host>] [--json]50 msごとにpingを送り、速度テストでは見逃す短い遅延の急増と、その発生タイミングや繰り返しの有無を調べます
kilobat starlink [--hours 1…720] [--json]このネットワーク上のStarlinkアンテナをローカルで読み取り:状態、地上局へのping、警告、空のマップと遮られている方向、お使いの設備・Starlinkのネットワーク・アンテナの再起動に分けた通信障害
kilobat games [--game <game> | --all | --match] [--json]Kilobatがpingを送れるゲームと送れないゲームを、理由とともに一覧表示します。--gameでは、そのゲームの各データセンター(Valveのリレー、Epicのpingサーバ、またはゲームがホストされているAWSやAzureのリージョン)に5回ずつpingを送り、最も近いものを示します。--matchでは、どのゲームでもプレイ中のマッチのサーバを見つけてpingを送ります。配信用オーバーレイですぐ使えます
kilobat airdrop [status|everyone|contacts|off] [--json]AirDropの公開範囲、AirDropリンク(AWDL)とそれを使っているもの。公開範囲を変更するとシステム設定が開きます
kilobat bluetooth [--json]Bluetoothデバイスと、それらがWi-Fiと2.4 GHz帯を共有しているかどうか
kilobat bluetooth audio [--json]AirPodsなどのBluetoothヘッドフォンで再生中に、音が乱れる原因(2.4 GHz、AirDrop、大きなダウンロード、弱い信号)と変えるべき点を順番に表示
kilobat local [check] [--quick] [--json]ここでキャストやプリントはできますか?応答したChromecast、AirPlay受信機、プリンタ、ネットワークがデバイス間通信を制限している可能性(検出結果だけでは断定しません)、プリンタやカメラ専用のWi-Fi、キャストがカクつく原因を表示します
kilobat dns [automatic|cloudflare|google|quad9|flush]DNSの確認・設定、またはキャッシュの消去
kilobat dns fastest [--all] [--json]Cloudflare、Quad9、Googleに対するアプリの静かな測定から、このネットワークで最速のDNSを表示。各運営元と所在地、過去14日間に応答した名前解決も示します
kilobat dns 自動 on|off [--network <name>]Pro:接続時に最速のDNSに切り替える(すべてのネットワーク、または1つのネットワーク)
kilobat dns exclude|include <resolver>リゾルバを測定と選択の対象から外す、またはIPアドレスで独自のリゾルバを追加する
kilobat dns fallback <resolver>|off最速のリゾルバが失敗した場合に、ネットワーク自体のDNSに戻る前に切り替えるリゾルバ

Wi-Fi

kilobat wifi [status]現在のネットワーク、信号、チャンネルと幅、リンク速度、Wi-Fi規格、セキュリティ、送信出力
kilobat wifi on|off|restart|disconnectWi-Fiの電源と接続を操作
kilobat wifi join <name> [--password-stdin]保存済みのネットワーク、または新しいネットワークに接続
kilobat wifi known優先順に並んだ保存済みネットワーク
kilobat wifi password|share <name>保存されたパスワード、またはスマートフォンで読み取るQRコードを表示
kilobat wifi nodes [name <node> <name>] [--json]このネットワークのメッシュノードまたはアクセスポイント、Macの接続先、近いノードが圏内にあるかを表示。オフィスなどの名前を付けられます
kilobat wifi reconnect [--json]近いノードに移動し、Macの接続先を表示
kilobat low-latency on [--for 15m|1h|2h] [--until-quit <app>]通話やゲーム中にAirDropとAWDLを一時停止。デフォルトは15分、最長4時間、またはアプリが終了するまで
kilobat low-latency offAirDropとAWDLを元に戻します。アプリで開始した一時停止にも使えます

スリープ防止とエージェント

kilobat awake [--display]Ctrl-CまでMacをスリープさせません。--lid-closedを付けない限り、蓋を閉じるとスリープします
kilobat awake --lid-closed [--for 2h|--until-quiet|-- <command>]アプリの電源ヘルパーを使い、蓋を閉じた状態でも最大8時間動作を続けます。設定で「蓋を閉じた状態での実行を許可」をオンにする必要があります
kilobat awake --for 90m|2h|45s一定時間スリープさせない
kilobat awake --until-quiet [--app <id>] [--quiet 1…60]ダウンロードまたは指定したアプリの通信が落ち着くまでスリープさせません。デフォルトでは16 KB/s未満が3分間続いた時点で終了します
kilobat awake -- <command> [args]コマンドの実行中はスリープさせず、終了後にそのプロセスが送受信したデータ量を報告し、同じ終了ステータスで終了します
kilobat awake --while-frontmost <app> [--display] [--for 2h]指定したアプリが最前面にある間だけスリープさせません。読書やプレゼン向けです。ほかのアプリに切り替えるとMacはスリープできます。アプリの終了時、バッテリー残量20%、または--forの時間で終了します。--displayで画面もオンのままにします
kilobat settings awake-on-power on|off電源アダプタが接続されている間はアプリがスリープさせず、外すと再びスリープできるようにします
kilobat settings keep-screen-on on|offアプリがスリープさせないすべての対象(タイマー、ダウンロード、エージェント、最前面のアプリ、電源接続中)で、画面もオンのままにします
kilobat sessions [--days N] [--json]アプリが記録したスリープ防止のセッションとAIエージェントの実行。使用データ量とネットワークの変化も表示
kilobat agent-log [--all] [--since 2h|3d|date] [--agent claude] [--flagged] [--json]AIエージェントとそれが起動したコマンドが接続したすべてのホストを、バイト数とフラグ付きで表示:最新のセッション、またはエージェントから実行した場合はそのエージェント自身のセッション。記録はアプリ(Pro)が行います
kilobat history forget <host> [--subdomains] [--json]ホストをブロックされた試行、エージェントネットワークログ、エージェントの実行履歴の接続先、保護の通知履歴から削除
kilobat history clear --hour|--today|--all [--json]これらのホスト履歴を過去1時間、午前0時以降、またはすべて消去します。今後のアクティビティは再び記録される場合があります
kilobat agent-log --watch [--agent claude] [--flagged] [--json]同じ内容をアプリなしでこのターミナルにリアルタイムで記録します。保存はされません
kilobat protect [status|on|off|update] [--threats|--trackers|--agents] [--json]保護機能:既知のマルウェア、フィッシング、詐欺のホストのブロック(Pro)、アプリ内のトラッカーのブロック(無料、デフォルトでオフ)、エージェントガード(Pro)。updateはリストをすぐにダウンロードします
kilobat protect check <host> [--json]ホストが脅威リストやトラッカーリストに載っているか、どのリストか、Kilobatがブロックするかを表示します。ブロックする場合は終了コード1
kilobat protect allow|unallow <host>サイトとそのサブドメインを保護機能のすべてのリストの対象外にするか、それを元に戻します
kilobat agent-event <start|working|waiting|done|failed> [--agent name] [--stdin-json|--json-arg]エージェントのフック用:実行の開始、入力待ち、完了をアプリに伝えます。何も出力せず、常に0で終了します
kilobat why <url|host> [--app <id>] [--proxy <url>] [--context container|vm|remote|provider] [--failed-at <time>] [--error <text>] [--json]接続を妨げる層を特定します。ネットワークとインターフェース、プロキシとアプリ自身のプロキシ、DNS、Kilobatのルール、IPv4とIPv6、TLS、サーバと各リダイレクト、このネットワークによるブロックや地域によるサービスの拒否を調べます。指定されたURLにリクエストを送り、出力ではクエリの値を隠します。kilobat doctor <url|host>も利用できます
kilobat down [service|host…] [--all] [--list] [--json]サービス側の問題か、自分の接続の問題かを確認。Slack、Zoom、GitHub、Claude、OpenAIなど約70のサービスの公開ステータスページが現在報告する内容と、ここから接続できるか、このネットワークでブロックされているか、お住まいの地域で利用できないかを表示します。サービスを指定しない場合はこのMacで実行中のアプリを対象にします
kilobat explain <process|host…> [--process name --host name] [--json]macOSのプロセスやホストについて、通常の通信量、ブロックして安全か、何が使えなくなるかを、このMacにあるKilobat自身のデータベースから表示します。不明なものについてはKilobatが持つ情報を表示します
kilobat conditions [--json]従量制、省データモード、VPN、遅延、バッテリー、温度、蓋を閉じてよいかどうか。長時間の実行に向けたアドバイス付き

コントロール

kilobat profile [travel|work|unrestricted]プロファイルを一覧表示または選択
kilobat allow|block <bundle-id> [--minutes 1…1440] [--profile name]アプリのルールを保存。一時的なルールや、別のプロファイル向けのルールにもできます
kilobat reset <bundle-id> [--profile name]アプリのルールを削除し、デフォルトに従わせます
kilobat rules [--profile name] [--json]プロファイルのルール
kilobat limit [GB] [--cycle session|daily|weekly|monthly] [--reset-day N] [--alert 50,80,100]このネットワークのデータ予算、リセットのタイミング、通知のタイミングを確認・設定
kilobat quota <bundle-id> <GB> [--upload] [--all-networks]予算サイクルごとに1つのアプリのデータ量を制限。quota <bundle-id> --removeで解除します
kilobat quota --list [--json]アプリの割り当てと、今のサイクルでの使用量
kilobat pack [status] [--json]旅行用eSIMなどのデータパックについて、残量と過去3日間のペースで使い切る日を表示
kilobat pack add <GB> <days|YYYY-MM-DD> [--network <name>] [--name <label>] [--start YYYY-MM-DD]このネットワーク、Kilobatが検出したネットワーク、または名前に指定の文字を含むすべてのネットワークにデータパックを追加
kilobat pack correct <GB-left> [--pack <name>]KilobatはこのMacのみを集計するため、通信事業者のアプリに表示される残量を設定
kilobat pack end [--pack <name>]データパックを今すぐ終了。履歴には残ります
kilobat updaters [--json]従量制ネットワークで一時停止しているアップデータ、このネットワークで通過してしまったアップデートのバイト数、アプリ内で自らアップデートするアプリ
kilobat updaters on|offネットワークが従量制の間、Google UpdaterやmacOSのソフトウェアアップデートなどのアップデート用ヘルパーを一時停止します(デフォルトでオン)。アプリ自体は使い続けられます
kilobat settings kill-switch on|offPro:VPNが切断されている間、新しい接続をブロックします。kill-switch-lan on|offで、その間もローカルネットワークに接続できるようにします
kilobat uploads [--json]現在大量にアップロードしているアプリを、速度、これまでに送信した量、合計がわかる場合は残り時間とともに表示し、後で送信するために保留中のアップロードも表示します
kilobat uploads hold <app> [--until unmetered|fast|fast:<Mbps>|2h|manual]アプリのアップロードを、定額またはより速いネットワークまで、一定時間、または再開するまで保留します(Pro)。uploads resume <app>で送信を再開します
kilobat settings [name [value] ]new-apps(allow、ask、block)、apple-software、auto-travel、pause-updaters、kill-switch、awake-on-power、public-ip(デフォルトはオフ)、speed-streams、alerts、menu-barなどの設定を確認・変更
kilobat verdict <host> [--app <id>] [--port N] [--incoming] [--json]Kilobatが接続を許可またはブロックする理由:一致するすべてのルールをフィルタのチェック順に表示し、判定したルールと各ルールを変更するコマンドを示します。verdict --app <id>でアプリ自身のルールを表示
kilobat verdict --blocked [1…50] [--json]最新のブロックされた試行について、フィルタがブロック時に記録したルールを表示
kilobat approvals [--json]新しいアプリを確認するモードで承認待ちになっているアプリ。署名者と接続先も表示
kilobat approve|deny <app-id> [--minutes 1…1440]待機中のアプリをすぐにブロック、または許可するかどうかをKilobatで本人に確認
kilobat block-host|unblock-host <domain|IP|CIDR> [--app <id>]ドメイン(サブドメインを含み、*.example.comも可)、IP、範囲を、すべてのアプリまたは1つのアプリについてブロック
kilobat quit <PID> [--force]プロセスを終了

セットアップ

kilobat openMacアプリを開く
kilobat doctorアプリ、ネットワークフィルタ、モニタリングを確認
kilobat completion [zsh|bash|fish]シェル補完スクリプトを出力
kilobat mcpAIエージェント向けにMCPサーバをstdioで実行
kilobat updateHomebrewでインストールしたものをアップデート

上級

kilobat destinations [--pid PID] [--json]プロセスのソケットの観測結果
kilobat devices [--all] [--bonjour] [--json]ネットワーク上のデバイスを新規、既知、不明、無視の状態、種類、Kilobatの判定の確かさとともに表示。--allで現在接続していないデバイスも追加します
kilobat devices name <MAC> <name>デバイスに名前を付ける
kilobat devices mark <MAC> mine|unknown|ignoredアプリの通知と同じように、新しいデバイスについて回答
kilobat devices type <MAC> <type>|autoデバイスの種類を設定(camera、doorbell、tv、speaker、printer、plug、hub、console、phone、computer、drone、router、nasなど)。autoでKilobatの判定に戻します
kilobat household [--json]アプリでペアリングしたMacと、それぞれの現在の通信。ペアリングはアプリでのみ行います
kilobat smarthome [--json]Threadネットワークとボーダールーター、MatterとHomeKitのデバイス、ネットワークがMatterに対応できるかを表示。読み取り専用
kilobat trace <host> [--rounds 2…10] [--json]最大12ホップの経路調査。--roundsで複数回トレースし、各ホップのロスと遅延を表示
kilobat route-history --host <host> [--json]ホストへの保存済みトレースをすべて、mtrのようにホップごとに表示:ロス、最小、平均、最大、経路の変化、遅延が始まる場所
kilobat http-check <URL> [--json]DNS、接続、TLS、最初のバイトまでのタイミング
kilobat dns-benchmarkリゾルバのタイミング
kilobat lan-test <server> [--reverse] [--json]iperf3 -sを実行しているデバイスへの5秒間のiperf3テスト。iperf3が必要ですが、Kilobatがインストールすることはありません
kilobat interfaces [--json]物理インターフェイスとVPNのカウンタを個別に表示
kilobat capture <interface> <file.pcap>上限付きのパケットキャプチャ
kilobat connection-rule allow|block <app> <host> [port]接続先ルールを保存
kilobat blocklist status|import <path>|clearドメインのブロックリストを管理
kilobat wake <MAC-address>Wake-on-LANパケットを送信
kilobat spots [save <name>|remove <id>]保存したWi-Fiの場所
kilobat outages / speed-history [--days N]記録された障害と速度テストをJSONで出力

スクリプトとJSON

パイプ時は出力が自動でJSONに切り替わるため、スクリプトで人間向けの表示を解析する必要はありません。明示したい場合は--jsonを指定します。

kilobat diagnose | jq .health            # "good"、"degraded"、"poor"、"unknown" のいずれか
kilobat status --watch --json             # 1 秒ごとに 1 行につき 1 つの JSON オブジェクト
kilobat report --summary --days 7 --json  # 日別合計と使用量の多いアプリ
kilobat report compare --total 40GB --period last-month --csv  # プロバイダの数値と並べて表示

NO_COLORを設定すると色をオフにできます。DNSの変更には管理者の承認が必要です。