CLI コマンドリファレンス

​

コマンドの概要

​

status

npx cc-safety-net status

​

判定

plugin cc-safety-net@cc-marketplace is disabled in Claude Code; nothing is enforced in Claude Code until it is re-enabled. Other integrations are not affected.

​

出力

​

終了コード

​

doctor

npx cc-safety-net doctor
bunx cc-safety-net doctor

• エージェント連携が設定されていません。
• hook の検査に失敗しました。
• ユーザーまたはプロジェクトのルール設定が無効です。
• policy、config、audit のいずれかのディレクトリが安全ではありません。現在のユーザーの所有ではない、グループまたはその他のユーザーに書き込み権限がある、シンボリックリンクである、ディレクトリではない、のいずれかに当てはまる状態を指します。

​

管理対象 hook の設定ずれ

• Error (Antigravity CLI): Failed to parse Antigravity hooks config <path>: <reason>
• Error (Cursor): Failed to parse Cursor hooks config <path>: <reason>
• Error (Grok Build): Failed to parse Grok Build hooks config <path>: <reason>

​

logs

npx cc-safety-net logs
npx cc-safety-net logs --suspect --since 7
npx cc-safety-net logs --id 3fa9c2d1a70e8b42

​

フィルターとオプション

• --id は、--agent、--rule、--session、--project、--suspect、--since、--limit と同時に使えません。
• --prune-legacy は、--id、--agent、--rule、--session、--project、--suspect、--all、--since、--limit と同時に使えません。一緒に使えるフラグは --json と --dry-run だけです。

​

機械可読出力

​

logs —prune-legacy

​

explain

npx cc-safety-net explain "git reset --hard"
bunx cc-safety-net explain "git reset --hard"

npx cc-safety-net explain "rm -rf /"
npx cc-safety-net explain --json "git checkout -- file.txt"
npx cc-safety-net explain --cwd /tmp "git status"

• 不明なオプションは 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 で終了します。

npx cc-safety-net explain --json 'loop() { loop; }; loop'

{"error":"Structural command analysis limit exceeded."}

​

rule

​

rule init

npx -y cc-safety-net rule init
npx -y cc-safety-net rule init --global

npx -y cc-safety-net rule init --example

​

rule add

cc-safety-net rule add project-rules
cc-safety-net rule add acme/safety-rules
cc-safety-net rule add acme/safety-rules --only aws gcloud
cc-safety-net rule add acme/safety-rules --ref v2 --only aws
cc-safety-net rule add --only terraform aws

• Added <n> rulebooks from <source> at <ref>:（1 件の場合は rulebook）に続けて、rulebook ごとに - <name> の行
• 選択した rulebook のうち rule.json にすでにあったものについて Rulebooks already configured from <source> at <ref>: <names>
• Vendored at <commit>.。解決されたコミットを先頭 7 文字に短縮したもので、新しい設定元を 1 つ以上書き込んだ場合にのみ出力される
• 書き込んだファイルごとに 1 ブロック。新規ファイルは Vendored <spec> (<version>)、既存ファイルの更新は Updated <spec> (<before> -> <after>) に続けて、追加・削除・名前は同じで内容が変わったルールをそれぞれ + <rule>、 - <rule>、 ~ <rule> の行で表示
• Rule config updated.、空行、Active rulebooks (<n>):。各エントリは - <name> <version> (<n> rules) と Source: <spec>

​

rule remove

npx -y cc-safety-net rule remove project-rules
npx -y cc-safety-net rule remove project-rules --delete-source

• その間に別のプロセスがファイルを追加した場合、2 回目の確認が削除を拒否し、Local rulebook source directory contains extra files: <dir>. delete manually if you really want to remove the directory. を出力します。設定の変更はロールバックされて再同期されるため、削除しようとした設定元は元に戻ります。
• 削除は再帰的ではありません。検証済みの rulebook.json を削除してから、非再帰の rmdir でディレクトリ自体を削除します。unlink の後にファイルが追加されると rmdir が失敗し、そのファイルはそのまま残ります。削除されるのは rulebook ファイルだけです。
• 削除の時点でディレクトリがすでにない場合は、削除をスキップして成功として報告します。求められた最終状態に達しているためです。

​

rule update

npx -y cc-safety-net rule update
npx -y cc-safety-net rule update project-rules

​

rule sync

npx -y cc-safety-net rule sync

`cc-safety-net rule sync` is deprecated: rulebooks are live files that need no synchronization. This run only migrates the lock and cache an earlier version left behind.

​

rule list

npx -y cc-safety-net rule list

Active rules (1):
  - [project] infra/block-terraform-destroy
      Command: terraform apply
      Any args: -destroy, --destroy
      Exclude args: --dry-run
      Reason: Review a destroy plan first.

​

rule wrapper

npx -y cc-safety-net rule wrapper list
npx -y cc-safety-net rule wrapper add rtk
npx -y cc-safety-net rule wrapper remove rtk

• 操作の指定は必須で、add、remove、list のいずれかでなければなりません。
• wrapper list は追加の引数を受け取りません。Transparent wrappers: (none) または番号付きリストを出力します。
• wrapper add と wrapper remove は、それぞれ正確に 1 つのコマンド名が必要です。
• ラッパー名は ^[a-zA-Z][a-zA-Z0-9_-]*$ に一致する必要があります。予約済みコマンドはラッパーとして登録できません。
• add は重複を除去し、remove はフィルタリングします。スコープは -g / --global に従います。

​

rule verify

npx -y cc-safety-net rule verify

"$schema": "https://raw.githubusercontent.com/kenryu42/cc-safety-net/main/assets/cc-safety-net.schema.json"

​

rule migrate

npx -y cc-safety-net rule migrate
npx -y cc-safety-net rule migrate --cleanup

​

rule doc

npx -y cc-safety-net rule doc

UPDATE_AVAILABLE: cc-safety-net v<latest> is available (running v<current>). Ask the user once whether to run `npx -y cc-safety-net@latest update`; continue the current task either way and do not raise this again.

​

policy

cc-safety-net policy check proposal.json
cc-safety-net policy apply proposal.json
cc-safety-net policy apply proposal.json --global

​

出力

Scope: project (<path>)
Proposal: <file>
Effective policy (user + project merged):
Changes (<n>):
  <field>: <before> -> <after>

<file>: audit settings are user scope only; remove the audit section from a project proposal

​

適用

policy apply confirms interactively; run this yourself in a terminal:
  cc-safety-net policy apply <file>

Only the user may apply a policy proposal, because it rewrites the configuration CC Safety Net enforces. Ask them to run `cc-safety-net policy apply <file>` themselves in a terminal; you can run `cc-safety-net policy check <file>` to show them what it would change.

​

install

npx -y cc-safety-net install
npx -y cc-safety-net install --claude-code

​

ターゲット

​

インストールの仕組み

• ネイティブのプラグインまたは拡張機能のコマンド：Claude Code、Codex、GitHub Copilot CLI、Gemini CLI、OpenClaw、OpenCode、Pi。CC Safety Net はエージェント自身のプラグインマネージャーを実行し、置き換えられた古いプラグイン ID を削除します。OpenClaw のインストールは、その後に OpenClaw がプラグインを読み込み済みと報告することも確認し、OpenClaw Gateway の再起動を求めます。OpenCode のインストールは、キャッシュ済みパッケージのエントリを import し、呼び出し可能な CCSafetyNetPlugin を export することを確認します。OpenCode が何も読み込まず fail open になる場合、インストールは失敗します。
• 設定ファイルへの書き込み：Antigravity CLI、Cursor、Grok Build、Kimi Code。CC Safety Net がエージェントの設定を直接編集するのは、この 4 つだけです。
• 管理対象プラグイン成果物：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 の再起動が必要です。

​

ターゲットの選択

• フラグなしの対話型ターミナル： 矢印キーを使う複数選択プロンプトが表示されます。各ターゲットの使用可否を調べます。そのため、エージェントがインストールされていない場合は CLI not installed、設定済みの場合は already installed、uninstall 時に未設定の場合は not installed と表示されます。Windows では、この使用可否の検査もインストール自体も npm の .cmd シムをシェル経由で解決するため、npm でインストールした CLI が CLI not installed と表示されることなく検出されます。
• ターゲットフラグあり： 正確に 1 つのターゲットフラグを指定します。複数指定すると Choose exactly one install|uninstall target: の後に完全なフラグリストを表示します。不明な - 引数と余分な位置引数もエラーです。

Space: select  Enter: confirm  u: update installed  Up/Down: move  q/Esc: cancel

​

update

npx -y cc-safety-net@latest update

Update available: cc-safety-net <current> → <latest>. Update this CLI with your package manager, e.g. `npm i -g cc-safety-net@latest` for a global install.

​

uninstall

npx -y cc-safety-net uninstall
npx -y cc-safety-net uninstall --cursor

​

hook

​

Antigravity CLI エントリーポイント

​

Cursor エントリーポイント

​

Grok Build エントリーポイント

​

gui

npx cc-safety-net gui
npx cc-safety-net gui --no-open

​

オプション

​

statusline

bunx cc-safety-net statusline --claude-code
# -cc is the short form of --claude-code
bunx cc-safety-net statusline -cc

​

グローバルオプション

npx cc-safety-net --version
npx cc-safety-net -V
npx cc-safety-net --help
npx cc-safety-net -h

npx cc-safety-net help explain
npx cc-safety-net explain --help
npx cc-safety-net help doctor