cc-safety-net という 1 つの CLI があります。npx cc-safety-net または bunx cc-safety-net で実行します。
適用処理は、cc-safety-net install が設定するプラグイン、拡張、フックを通して、エージェント内で動作します。CLI 自体をグローバルにインストールする必要はありません。npx または bunx は、ここで説明するコマンドの実行時に CLI を取得します。
このページは、コマンド、サブコマンド、オプション、終了動作を示すコマンドインターフェースのリファレンスです。チュートリアルではありません。ガイド付きの初回実行については、クイックスタートを参照してください。エージェントごとの設定については、インストールを参照してください。
コマンドの概要
CLI は 11 個のコマンドを登録します。次の順序は、cc-safety-net --help に表示される順序です。
doctor には別名 --doctor もあります。コマンド検索では大文字と小文字を区別しません。
status と statusline は異なる 2 つのコマンドです。status は人向けの複数行レポートを出力します。statusline はステータスバー向けに、絵文字インジケーターの正確に 1 行だけを出力します。status
status は、「ランタイムが現在何を適用しているか」という 1 つの質問に答えます。保護を信頼する前に、保護が動作していることを最も速く確認する方法です。
判定
先頭の判定は、次の 2 値のいずれかです。
無効な Claude Code プラグインは、独自の判定ではなくなりました。その 1 つの統合に限定した、
Not active リストの最初の項目として報告されます。
~/.claude/settings.json がない、解析に失敗する、enabledPlugins がない、または cc-safety-net@cc-marketplace を true に設定していない場合、プラグインは無効と見なされます。検査の既定値は無効なので、読み取れない設定ファイルは、有効ではなく無効として扱われます。
判定はポリシースナップショットから取得され、設定から再導出されることはありません。プラグイン検査はその項目を追加するだけで、判定を変更しません。
出力
status は、判定行、整列した情報ブロック、確認または問題のリストを順に出力します。
情報行は 1 行です。長い値は折り返さず、
… で切り詰めます。
情報ブロックの後に、status は Everything configured is active.、または Not active セクションを出力します。後者には、問題ごとに折り返した項目があり、該当する場合はプラグイン無効の項目が最初、その後にスナップショット診断が続きます。最後に Full report: cc-safety-net doctor を出力します。
NO_COLOR が設定されている場合、または stdout が TTY でない場合、出力は ASCII になります。チェックとクロスのグリフの代わりに ok / OFF、· の代わりに - を使い、シールドの接頭辞はありません。
終了コード
判定が
degraded の場合も含め、status は常に 0 で終了します。情報提供専用なので、スクリプトを失敗させません。問題でゼロ以外の終了コードが必要な場合は、doctor を使ってください。doctor
doctor は、インストールと設定の完全な正常性検査を実行し、セクションに分けたレポートを出力します。
オプション：
doctor は、失敗を検出するとゼロ以外のコードで終了します。設定済みのエージェントがない、フック検査に失敗した、セルフテストに失敗した、ユーザーまたはプロジェクト設定が無効な場合などが失敗です。
一部の監査ログファイルを読み取れない場合、Recent Activity セクションの末尾に Warning: <n> audit log sources could not be read; this summary is incomplete が表示されます（1 件の場合は source）。これにより、操作が少ない週を完全なデータと誤認しません。
logs
logs は、1 つの許可またはブロックされたコマンド判定を 1 レコードとして、監査ログを読み取ります。
logs はすべてのプロジェクトについて、過去 30 日間の最新の拒否 20 件を出力します。許可判定も含めるには --all を指定します。
フィルターとオプション
--suspect は、再確認する価値がある拒否に結果を絞ります。failureStage を持つ拒否（解析に失敗し、ガードが fail-closed になったため、コマンドが危険だと証明されたわけではない）、または同じセッション内で同じコマンド署名が 2 回以上拒否された場合です。繰り返し回数は、--limit で出力を切り詰める前に、--since の期間全体で数えます。
同時に使えない組み合わせ。 次の 2 つは、明示的なメッセージと終了コード 1 で拒否されます。
--idは、--agent、--rule、--session、--project、--suspect、--since、--limitと同時に使えません。--prune-legacyは、--id、--agent、--rule、--session、--project、--suspect、--all、--since、--limitと同時に使えません。一緒に使えるフラグは--jsonと--dry-runだけです。
--dry-run だけを指定することも拒否されます。--dry-run requires --prune-legacy を出力し、1 で終了します。
認識しないオプションは Unknown option for logs: <arg> を出力し、1 で終了します。
監査ログファイルを読み取れない場合、またはレコードが不正な場合、logs は stderr に 1 つの警告 warning: <n> audit log sources could not be read; these results are incomplete を出力します（1 件の場合は source）。stdout と終了コードは変更しません。
機械可読出力
人向けの出力では、エントリごとに ID、タイムスタンプ、判定、エージェント、ルール ID、50 文字に切り詰めたコマンドを 1 行で出力します。完全なコマンドと異なるセグメントには
↳ が付きます。--id は、代わりにレコードのすべてのフィールドを含むラベル付き詳細ブロックを出力します。
logs —prune-legacy
ネストされたプロジェクトごとの監査ログには触れません。コマンドは実行後にそのことを表示します。すべての削除に成功すると0、いずれかのファイルを削除できないと 1 で終了します。削除対象がない状態で再度実行すると、何もしません。
--dry-run では何も削除しません。コマンドは Would remove <n> legacy audit log files (<size>).、または No legacy audit log files found. を出力し、次に Nested v2 audit logs are not included. を出力します。削除対象がある場合は、Run the same command without --dry-run to delete them. も出力します。常に 0 で終了します。--json と一緒に使うと、代わりに 1 つのコンパクトオブジェクト {"dryRun":true,"files":n,"bytes":n} を出力します。
レガシー配置と現在の配置の違いについては、監査ログを参照してください。
explain
explain は、CC Safety Net がコマンドを解析する方法を手順ごとにトレースします。コマンドがブロックまたは許可される理由、カスタムルールが適用される方法を確認するために使います。
-- はフラグ解析を終了します。その後にあるすべてのものがコマンドです。残りの引数が 1 つなら、シェル演算子を維持するため、そのまま使います。複数の引数は再度引用します。
例：
explain はブロックと許可のどちらの結果でも 0 で終了します。終了コードではなく result フィールドを読んでください。失敗するのはオプション検証だけです。
- 不明なオプションは
Unknown option for explain: <arg>を出力します。値がない--cwdは--cwd requires a valueを出力します。どちらの解析エラーにもUsage: cc-safety-net explain [--json] [--cwd <path>] <command>とPass -- before a command that starts with dashes.が続き、1で終了します。 - 存在しない
--cwdパスはError: --cwd path does not exist: <path>を出力し、1で終了します。 - 空のコマンドは
Error: No command providedと使用方法の行を出力し、1で終了します。
-- を処理します。最初の -- で --help と --version の検索を停止します。そのため、explain -- --help はヘルプを出力せず、リテラルコマンド --help を explain します。
--json が返す JSON スキーマ、つまり ExplainResult フィールドとすべての TraceStep バリエーションについては、explain トレースリファレンスを参照してください。
rule
rule は、ルール設定、ルールブックソース、透過コマンドラッパーを管理します。このセクションではコマンドインターフェースを説明します。ルールブックのスキーマ、ライフサイクル、オーバーライドの意味については、カスタムルールを参照してください。
サブコマンドなしで rule を実行すると、ヘルプを出力して 1 で終了します。rule --help は同じヘルプを出力して 0 で終了します。
オプション：
rule init
現在の範囲にルール設定を作成します。ファイルが存在する場合は、rules、overrides、transparent_wrappers を維持したまま、正規形式に書き換えます。必要な場合は、ルールブックキャッシュディレクトリも作成します。
rule init だけを実行すると、ルールを含まない非アクティブな設定を書き込みます。example-rules という開始用ルールブックも書き込むには、--example を指定します。
example-rules/rulebook.json が存在しない場合にのみ書き込まれます。設定から参照されないため、非アクティブです。有効にするには、rule add example-rules で追加します。
rule add
ルールブックソースを追加して同期します。<source> は、裸のローカル名（例は project-rules）、または owner/repo#ref/<rulebook-name> 形式の GitHub ソースです。
rule remove
ルールブックソースを削除して同期します。ローカルソースディレクトリに変更がない場合に、そのディレクトリも削除するには--delete-source を追加します。
rule update
設定済みのルールブックソースについて、ロックとキャッシュを更新します。ソースを 1 つ指定した場合は、そのソースだけを更新します。rule update は、rule sync と正確に同じです。
rule sync
すべての設定済みルールブックソースについて、ロックとキャッシュを再構築します。rule.json を手動で編集した後に実行します。
--check を指定すると、update と sync は Rule config synced. ではなく Rule config checked. を報告し、ロックとキャッシュの状態を変更しません。
rule list
ユーザー範囲とプロジェクト範囲の両方について、有効なルールブックと解決済みソースを一覧表示します。rule list は両方の範囲を一度に読み取るため、--global は拒否されます。ポリシーのエラーがある場合だけ 1 で終了します。警告は出力されますが、終了コードは 0 です。
rule wrapper
透過コマンドラッパーを管理します。これは引数を別のコマンドへ渡すコマンドであり、CC Safety Net はラッパー自体ではなく内部のコマンドを解析します。- action は必須で、正確に
add、remove、listのいずれかである必要があります。 wrapper listは追加の引数を受け取りません。Transparent wrappers: (none)または番号付きリストを出力します。wrapper addとwrapper removeは、それぞれ正確に 1 つのコマンド名が必要です。- ラッパー名は
^[a-zA-Z][a-zA-Z0-9_-]*$に一致する必要があります。予約済みコマンドはラッパーとして登録できません。 addは重複を除去し、removeはフィルタリングします。範囲は-g/--globalに従います。
transparent-wrapper 手順として表示されます。
rule verify
レガシーパスとスキーマ種類の検出を含め、両方の範囲のルール設定ファイルを検証します。設定を手動で編集した後に使います。0、それ以外はゼロ以外で終了します。
rule verify は純粋な検査ではなく、検証するファイルを変更することがあります。範囲の rule.json が正常に検証されても $schema キーがない場合、コマンドはそのファイルを書き換え、次の内容を最初のキーとして挿入します。
Added $schema to user config. または Added $schema to project config. を出力します。これは、ユーザーまたはプロジェクト範囲にある有効な rules-schema 設定でのみ動作します。レガシー設定またはエラーがある設定では動作しません。無効にするフラグはありません。書き換えはファイル全体を 2 スペースのインデントで再シリアライズします。そのため、CI では追跡対象ファイルに変更が残る場合があります。rule verify を読み取り専用にする必要がある場合は、先に $schema キーをコミットしてください。
rule migrate
レガシーのインライン設定ファイル、プロジェクトの.safety-net.json とユーザーの ~/.cc-safety-net/config.json を、ルールブック配置に変換します。
--cleanup は、移行したルールの検証後にレガシーファイルを削除します。migrate は、--global、--check、2 つ目の位置引数を拒否します。
rule doc
ルールブック作成ガイドを stdout に出力します。ルールブックの作成または検証のため、ガイドをエージェントへパイプできます。rule doc は新しいバージョンが npm レジストリにあるかを確認します。検査は 24 時間に最大 1 回で、結果は ~/.cc-safety-net/update-check.json にキャッシュされます。新しいバージョンがある場合は、stderr に正確に 1 行を書き込みます。
CC_SAFETY_NET_NO_UPDATE_CHECK を設定します。レジストリ検査の失敗は通知されず、いずれの場合も終了コードは 0 のままです。
install
install は、CC Safety Net をコーディングエージェント CLI にインストールします。ターゲットセットは CC Safety Net の統合カタログから取得されるため、GUI と doctor が使うリストと同じです。
エージェントごとの手順、インストール後の操作、レガシープラグイン ID の移行については、インストールを参照してください。
ターゲット
12 個のターゲットを使用できます。次の順序はインストールされる順序です。インストールの仕組み
CC Safety Net は、3 つのインストール方法を使います。- ネイティブのプラグインまたは拡張コマンド — Claude Code、Codex、GitHub Copilot CLI、Gemini CLI、OpenClaw、OpenCode、Pi。CC Safety Net はエージェント自身のプラグインマネージャーを実行し、置き換えられた古いプラグイン ID を削除します。OpenClaw のインストールは、その後に OpenClaw がプラグインを読み込み済みと報告することも確認し、OpenClaw Gateway の再起動を求めます。
- 設定ファイルへの書き込み — Antigravity CLI、Cursor、Kimi Code。CC Safety Net がエージェントの設定を直接編集するのは、この 3 つだけです。
- 管理対象プラグイン成果物 — Amp Code と Hermes Agent。Amp のプラグインは、amp CLI を通じてアカウントのホスト型 Amp Personal Plugins リポジトリに公開されます（事前確認は
amp plugins repositories --json）。そのため、インストールには amp CLI とamp loginが必要です。公開されたプラグインは、Orb スレッドを含むすべての Amp セッションに適用されます。~/.config/amp/plugins/cc-safety-net.tsに管理対象のローカルコピーが残っているとパーソナルプラグインを覆い隠すため、インストール時に削除されます。変更後は Amp を再起動するかplugins: reloadを実行します。Hermes Agent では、インストール時にプラグインをディスクに書き込んでhermes plugins enableも実行し、変更後に Hermes の再起動が必要です。
npx キャッシュから古い cc-safety-net を削除します。npm キャッシュの _npx ディレクトリ（$npm_config_cache が設定されている場合はその場所。それ以外は macOS と Linux で ~/.npm、Windows で %LOCALAPPDATA%\npm-cache）の下にあり、node_modules が cc-safety-net を含むすべてのエントリを削除します。この 4 つの統合は npx でフックを実行するため、この処理により、新しくインストールしたフックはキャッシュ済みのバージョンではなく最新版を解決します。
Kimi Code には 2 つのインストール方式があります。 ターミナルで install --kimi-code を実行するか、ピッカーで Kimi Code を選択すると、単一選択プロンプトが開きます。グローバルフックを今インストールするか、代わりにネイティブ Kimi プラグインの手順を表示するかを選びます（手順は、Kimi Code 内で /plugins install https://github.com/kenryu42/cc-safety-net を実行し — 信頼プロンプトのデフォルトはキャンセルです — 次に /reload を実行するか新しいセッションを開始します）。プラグイン方式を選んでも何も書き込まれず、手順を表示するだけです。非対話セッションではプロンプトをスキップして、グローバルフックを直接インストールします。このプロンプトがプラグイン手順への唯一の経路であるため、グローバルフックが設定済みでも install 時の Kimi Code の行は選択可能なままで、(global hook installed) と表示されます。
ターゲットの選択
- フラグなしの対話型ターミナル： 矢印キーを使う複数選択プロンプトが表示されます。各ターゲットの使用可否を調べます。そのため、エージェントがインストールされていない場合は
CLI not installed、設定済みの場合はalready installed、uninstall 時に未設定の場合はnot installedと表示されます。Windows では、この使用可否の検査もインストール自体も npm の.cmdシムをシェル経由で解決するため、npm でインストールした CLI がCLI not installedと表示されることなく検出されます。 - ターゲットフラグあり： 正確に 1 つのターゲットフラグを指定します。複数指定すると
Choose exactly one install|uninstall target:の後に完全なフラグリストを表示します。不明な-引数と余分な位置引数もエラーです。
Space は強調表示したターゲットの選択を切り替えます。Enter は確定します。何も選択されていない場合はターミナルベルを鳴らすだけです。Up / Down または k / j は、選択可能な行の間を移動します。install 時に u（または U）を押すとセレクターを終了して update フローを実行します。uninstall のフッターにはこのキーがありません。q または Esc で終了すると、Cancelled: nothing was installed.（または Cancelled: nothing was uninstalled.）を出力し、0 で終了します。終了は判定であり、失敗ではありません。一方、Ctrl-C は SIGINT を送出するため、通常の中断されたプログラムと同じ方法でプロセスが終了します。
選択したターゲットは、選択した順序ではなく、常にカタログのインストール順で実行されます。ターミナルでは、各ターゲットはスピナー — Installing <name> integration… または Uninstalling <name> integration… — の後ろで実行され、スピナーが止まった後にレポートが表示されます。TTY でない場合、スピナーはありません。120 秒経っても終わらないホスト CLI のコマンドは強制終了され、失敗として報告されます。失敗すると、権限問題、パス不足、ディレクトリではないパス要素など、エラー固有のヒントとともに 1 で終了します。
update
update は、インストール済みのすべての統合を更新します。新しい統合をインストールすることはありません。設定していないエージェントには触れません。
amp plugins list の出力によって対象になります。この出力は、codex plugin list と同じく 30 秒のタイムアウトで取得します。コールドラン時は checkout をネットワーク経由で更新するため、デフォルトの 5 秒を超えることがあるからです。GitHub Copilot CLI は例外です。Copilot の installed-plugins ディレクトリに CC Safety Net プラグインの checkout がある場合だけ対象になります。無効状態と、何もインストールされていない kill-switch 状態を区別できず、update が install になることを防ぐためです。改名前の safety-net@cc-marketplace プラグイン ID を使うインストール — Claude Code、Codex、および GitHub Copilot CLI のプラグイン checkout cc-marketplace/safety-net — も検出されます。更新時に現在の ID へ移行し、レガシーコピーをベストエフォートで削除します。レガシーコピーの削除に失敗しても、ターゲットは失敗せず警告になります。
各ターゲットは、カタログのインストール順で install と同じ操作を実行し、メッセージだけが Updated … または … up to date に変わります。インストール時にエージェント自身の CLI を使うターゲット、つまり Claude Code、Codex、GitHub Copilot CLI、Gemini CLI、Hermes Agent、OpenClaw、OpenCode、Pi では、先にベンダーバイナリを調べます。バイナリがない場合は <Agent> not found; skipped（例は Codex not found; skipped）を出力して処理を続けます。設定ファイルを使うターゲット、つまり Antigravity CLI、Cursor、Kimi Code にはバイナリが不要で、常に更新されます。Amp Code には別途の検査は不要です。amp plugins list がパーソナルプラグインを表示する場合にのみ検出され、その更新は amp CLI を実行して現在の成果物を公開します。Claude Code、Codex、GitHub Copilot CLI では、登録済みのマーケットプレイスをプラグイン処理の前に更新します（例は claude plugin marketplace update cc-marketplace）。何もしない add に頼らないため、古いカタログ checkout が更新を失敗させることはありません。
対象がない場合、update は No installed integrations found. Run `cc-safety-net install` to set one up. を出力して 0 で終了します。
update はターゲットフラグも引数も受け取りません。使用できるのは -h / --help だけです。ほかのオプションは Unknown option for update: <flag>、位置引数は Unexpected argument for update: <arg> を出力し、どちらも 1 で終了します。1 つのターゲットが失敗しても実行は止まりません。エラーは install と同じヒントとともに表示され、update は残りのターゲットを続行し、いずれかのターゲットが失敗していれば最後に 1 で終了します。それ以外の終了コードは 0 です。
対話型の install セレクターで u を押して、update フローへ移ることもできます。
uninstall
uninstall は、install と同じ 12 個のターゲットフラグを受け取り、同じ選択ルールとターゲット順序を使います。
hook
hook は、CC Safety Net をエージェントのランタイムフックとして実行します。エージェントのフック入力を stdin から JSON として読み取り、そのエージェントの拒否形式を出力します。通常は手動で実行しません。エージェントのプラグインまたは設定が接続します。保護の背後にあるコマンドです。
hook には正確に 1 つの統合フラグが必要です。フラグがない場合、または複数ある場合は、hook requires exactly one integration flag. Try: cc-safety-net hook --kimi-code とコマンドヘルプを表示し、1 で終了します。
Amp Code、Codex、OpenClaw、OpenCode、Pi には、独自の
hook フラグがありません。Amp Code、OpenClaw、OpenCode、Pi は、プラグインまたは拡張として CC Safety Net をインプロセスで読み込みます。Codex のプラグインは、上記の共有 hook --coding-cli エントリポイントを呼び出します。各エージェントの接続方法については、統合アーキテクチャを参照してください。
Antigravity CLI エントリポイント
install --agy-cli は、コマンド npx -y cc-safety-net hook --agy-cli を ~/.gemini/config/hooks.json に書き込みます。Antigravity は .gemini ディレクトリを共有します。管理対象エントリの名前は cc-safety-net で、30 秒のタイムアウトを持つ PreToolUse コマンドフックを登録します。install は、ファイルがない場合は作成し、無効な管理対象エントリがある場合は再度有効にし、それ以外は新しいエントリを追加します。uninstall は、コマンドが管理対象文字列と一致するエントリだけを削除します。
実行時に、フックは Antigravity の run_command ツール呼び出しを読み、conversationId からセッション ID を取得し、{ "decision": "deny", "reason": … } で拒否します。
Cursor エントリポイント
install --cursor は、コマンド npx -y cc-safety-net hook --cursor を ~/.cursor/hooks.json の hooks.preToolUse に書き込みます。"version": 1 のドキュメントで、30 秒のタイムアウトと failClosed: true を設定します。インストーラーはドキュメントのバージョンと形式を検証し、認識できないものを書き換えず、説明付きエラーで失敗します。重複する管理対象エントリは 1 つにまとめられます。
実行時に、フックは Cursor の Shell ツール呼び出しを読み、conversation_id からセッション ID を取得し、{ "permission": "deny", … } または { "permission": "allow" } で応答します。Cursor の working_directory フィールドは workspace root に対して包含検査されます。宣言されているのに値がない場合、または workspace root の外を指す場合は fail-closed になります。
gui
gui は、ローカルのポリシーエディターを起動し、ブラウザーで開きます。ダッシュボードのビューと確認動作については、ダッシュボードを参照してください。
オプション
gui が受け取る引数は --no-open だけです。ほかの引数は、オプションなら Unknown option for gui: <arg>、位置引数なら Unexpected argument for gui: <arg> というエラーを出力し、次に Usage: cc-safety-net gui [--no-open] を出力して 1 で終了します。
サーバーは常に先に起動し、フラグの有無に関係なく、URL は常に CC Safety Net policy GUI: <url> として出力されます。--no-open はブラウザーの起動だけを抑制します。ブラウザーの起動失敗は致命的ではありません。gui は手動で開く URL を出力し、サーバーは動作を続けます。
サーバーはエフェメラルポートの 127.0.0.1 に bind し、実行ごとに新しいトークンを作成します。そのため、URL は http://127.0.0.1:<port>/?token=<token> のようになります。すべての要求にトークンが必要です。書き込みでは、さらにトークンをヘッダーで送る必要があります。その後、プロセスは中断されるまで動作します。
statusline
statusline は、エージェントのステータスバー向けに、CC Safety Net の現在の状態を絵文字インジケーターの 1 行として出力します。--claude-code（短縮形 -cc）が必要です。ない場合はエラーになり、ヘルプを表示して 1 で終了します。
🛡️ CC Safety Net ❌ と表示されます。それ以外は、レベルを絵文字で表示します。standard は ✅、strict は 🔒、paranoid は 👁️、customised は 🔧 です。worktree の緩和が有効な場合は 🌳、ポリシースナップショットが degraded の場合は末尾に ⚠️ が付きます。
入力がパイプされると、statusline は標準入力を読み取ります。Claude Code の JSON ステータスペイロードは破棄します。それ以外のパイプされたテキストは維持し、<stdin> | <status> としてインジケーターの前に置きます。
statusline と status は、同じポリシースナップショットと環境モードを使います。出力形式は異なります。ターミナルレポートには status、プログラムまたはステータスバーには statusline を使います。
設定手順と各インジケーターの意味については、ステータスラインの設定ページを参照してください。
グローバルオプション
いつでもインストール済みバージョンを確認し、使用方法を表示できます。--version の短縮形は -V、--help の短縮形は -h です。
help <command> または <command> --help を使います。
Unknown command: <name> を出力します。- で始まる場合は Unknown option: <name> を出力します。その後に Run 'cc-safety-net --help' for usage. を出力し、1 で終了します。不明なコマンドに対する help <name> は、代わりに Unknown command: <name> と Run 'cc-safety-net --help' for available commands. を出力します。表示するヘルプテキストを含め、これらの失敗パスのメッセージはすべて stderr に出力されます。