SWG bar CLI ガイド

SWG bar は、/Applications/SWGBar.app 内にネイティブコマンドラインツール swgbar を同梱しています。Mac のメニューバーアプリと同等の機能を提供し、ターミナルや自動化スクリプトから直接 TLS 証明書の監査、HTTPS 検査結果の確認、およびドメイン単位の SWG バイパス管理が行えます。

CLI のセットアップ

SWG bar をインストールした後、実行バイナリはアプリケーションバンドル内に配置されます。直接実行するほか、シェル設定ファイル（~/.zshrc や ~/.bashrc）にエイリアスを追加するか、PATH にシンボリックリンクを作成して利用できます：

# 方法 1：アプリケーションバンドル内のバイナリを直接実行
/Applications/SWGBar.app/Contents/MacOS/swgbar --help

# 方法 2：シェル設定ファイル（~/.zshrc または ~/.bashrc）にエイリアスを追加
alias swgbar="/Applications/SWGBar.app/Contents/MacOS/swgbar"

# 方法 3：/usr/local/bin にシンボリックリンクを作成（システム全体での利用に推奨）
sudo ln -s /Applications/SWGBar.app/Contents/MacOS/swgbar /usr/local/bin/swgbar

# CLI のインストールとバージョンを確認
swgbar version

構造化された JSON 出力が必要な場合は、任意のコマンドの末尾に --json を付加してください。jq などのツールと組み合わせたスクリプト処理に最適です。

概要指標、ドメイン、証明書の確認

overview、domains、certificates を使用して、メニューバーアプリに表示される情報と同じリアルタイムデータを確認できます：

# 全体の HTTPS 検査率、ステータス内訳、主要な中間者証明書を表示
swgbar overview

# 観測されたドメインの一覧表示とステータス絞り込み（confirmed, suspected, public, intranet）
swgbar domains list
swgbar domains list --status confirmed --page 1 --page-size 20
swgbar domains list --search <keyword> --bypass active

# 一覧から指定ドメインの接続と証明書証拠の詳細を表示
swgbar domains detail <domain>

# 証明書クラスターの一覧表示と指定した証明書名の詳細を表示
swgbar certificates list
swgbar certificates list --status suspected
swgbar certificates detail "<certificate-name>"

ドメインの調査と SWG バイパスの管理

任意のドメインをオンデマンドでリアルタイム TLS 調査したり、ドメイン単位の SWG バイパスルールを管理できます：

# 指定ドメインをオンデマンドで調査し、証明書信頼と TLS 検査を判定
swgbar probe <domain>

# 現在の SWG ドメインバイパス状態と適用ルールを確認
swgbar bypass status

# 指定ドメインのバイパス有効化、切り替え、無効化、全解除
swgbar bypass enable <domain>
swgbar bypass toggle <domain>
swgbar bypass disable <domain>
swgbar bypass clear

ブラウザー拡張機能とアプリ設定

ブラウザー拡張機能の接続確認、バックグラウンド監視の一時停止や再開、各種アプリ設定の管理もコマンドラインから行えます：

# Chrome 拡張機能の接続状態を確認
swgbar plugins status
swgbar plugins check

# バックグラウンド監視状態の確認、一時停止、再開
swgbar monitoring status
swgbar monitoring pause
swgbar monitoring resume

# ライセンス状態の確認、アップデート確認、言語や外観モードの切り替え
swgbar license status
swgbar updates check
swgbar language get
swgbar language set <en|zh-Hans|zh-Hant|ja|ko>
swgbar appearance get
swgbar appearance set <system|light|dark>

主なコマンド一覧

コマンド	説明
swgbar overview	全体の HTTPS 検査率、ステータス別統計、主要な中間者証明書を表示
swgbar domains list	ドメインを一覧表示（--search、--status、--bypass、--page、--page-size による絞り込みとページネーションに対応）
swgbar domains detail <domain>	指定ドメインの接続メタデータ、証明書チェーン証拠、バイパス状態を表示
swgbar certificates list	証明書クラスターを一覧表示（--search、--status による絞り込みに対応）
swgbar certificates detail "<certificate-name>"	指定証明書の発行情報、有効期限、SHA-256 フィンガープリント、影響を受けるドメインを表示
swgbar bypass <status|enable|disable|toggle|clear>	ドメイン単位の SWG バイパスルールの確認や管理
swgbar probe <domain>	指定ドメインをオンデマンドでリアルタイム TLS 調査
swgbar plugins <status|check>	ブラウザー拡張機能コンパニオンの接続状態を確認
swgbar monitoring <status|pause|resume>	バックグラウンドネットワーク監視の確認、一時停止、再開
swgbar license <status|activate|deactivate>	ライセンス有効化状態の確認や管理
swgbar updates check	アプリケーションの最新アップデートを確認
swgbar language <get|set>	表示言語の確認や切り替え（en、zh-Hans、zh-Hant、ja、ko）
swgbar appearance <get|set>	外観テーマの確認や切り替え（system、light、dark）

AI デスクトップクライアントから SWG bar を利用する方法については MCP ガイドを、証明書と判定基準の仕組みについては動作の仕組みをご覧ください。