Husk

開発者向けのローカルファーストなセキュリティスキャナーです。単一のバイナリで、アカウントは不要です。

インストール · クイックスタート · 使い方 · コマンド · 仕組み

husk は、侵害されたパッケージ、漏えいしたシークレット、リスクの高いインストールスクリプト、安全でない AI／MCP 設定をマシン上でスキャンし、修正が必要な項目を表示します。ローカルで実行されるため、ログインもアカウントも不要で、ファイルがマシンの外に送信されることはありません。オンラインスキャンで公開アドバイザリーデータベース（OSV.dev、npm、PyPI、GitHub、CISA KEV／FIRST EPSS）に送信されるのは、パッケージ名、バージョン、CVE ID のみです。--offline を指定すると、ネットワーク呼び出しは一切行われません。

独立した監査を受けていない、バージョン 1.0 未満のソフトウェアです。 リリース間でインターフェースが変更されることがあります。不具合の報告や質問は、Issues までお寄せください。

インストール

husk は Linux と macOS で動作します。Windows では WSL 内で実行してください。WSL ではインストールも動作も Linux とまったく同じです。Windows ネイティブ版はありません。

最新の署名付きリリースをダウンロードし、チェックサムを検証してインストールします。

curl -fsSL https://husk-security.dev/install.sh | sh

~/.local/bin にインストールされます。インストール先は HUSK_INSTALL_DIR または --install-dir で変更できます。このディレクトリがすでに PATH に含まれていない場合、シェルの起動ファイルへの追加を実行前に確認し、変更対象となるファイルの正確な名前を表示します。拒否した場合、またはターミナルなしで実行した場合は、代わりに追加するコマンドが 1 つ表示されます。--no-modify-path を指定すると、起動ファイルへの書き込みは一切行われません。

_{シェルにパイプするのは避けたいですか？ install.sh をダウンロードして内容を確認してから実行してください。すべてのリリースには cosign 署名と SLSA アテステーションが付いています。インストーラーは SHA-256 チェックサムを検証します（cosign が PATH にある場合は署名も検証します）。詳しくはリリースの検証をご覧ください。}

クイックスタート

husk            # print help (no subcommand does nothing else)
husk scan       # one-shot scan of the current directory, plain terminal summary
husk web        # serve the local web UI and open it in your browser
husk tui        # browse the latest scan in the terminal UI

サブコマンドを指定せずに husk を実行すると、git や cargo と同様にヘルプを表示して終了します。エントリーポイントは、スキャンしてレポートを表示する husk scan、ブラウザーで開くローカルのウェブ UI husk web、ターミナル UI の husk tui です。

使用方法

日常的に実行するコマンドをいくつか紹介します。すべてのサブコマンドとフラグを含む完全な一覧は、コマンドリファレンスを参照してください。

ディレクトリをスキャンして、検出結果レポートを表示します。

$ husk scan --offline .
packages: 286  findings: 36  critical: 5  high: 16  medium: 15  low: 0  info: 0

  critical risky-agent-config  AI agent is allowed unrestricted shell access
           .claude/settings.local.json:4
  high     lifecycle-script    Dangerous npm postinstall script
           package.json:6
  high     risky-agent-config  MCP config contains hardcoded secret
           .mcp.json:7
  ...

パッケージをインストールする前に検査します（OSV.dev にリアルタイムで問い合わせます）。

$ husk check [email protected]
!! vulnerable npm [email protected]
   advisory GHSA-35jh-r3h4-6jhm via OSV.dev
   Command Injection in lodash
   Install a fixed version instead, or avoid the dependency until one is available.

バージョンは @version を末尾に付ける方法（最後の @ で分割するため、@scope/[email protected] も使用できます）と、別の引数として指定する方法があります：husk check npm lodash 4.17.20。パッケージ名のみ（husk check lodash）を指定すると、npm とみなしてマルウェアに関する勧告のみを確認します。

Guide にある追跡対象の Safe Chain タスクを使って、通常のインストールとロックファイルからのインストールを保護します。Husk は、機能の弱いパッケージマネージャー用ラッパーを同梱するのではなく、MIT ライセンスの無料サードパーティーツールを推奨しています。

Review Aikido Safe Chain

プロジェクトポリシーをコミットします（パッケージのブロック／許可、トリアージ済みの検出結果の抑制、CI のしきい値の設定）。.husk/ ディレクトリはコミットすることを想定しています。

$ husk init
Created ./.husk/policy.toml
  `husk scan` and `husk ci` in this project now read this policy.

$ husk approve npm:lodash          # allow a package; recorded in policy + ledger

安全な修正を計画します（デフォルトではドライランです。--apply を指定すると、バックアップを作成して修正を書き込みます）。

husk fix                          # show the plan, change nothing
husk fix --apply                  # write the auto-safe fixes

CI でビルドを判定します。標準出力に JSON を出力し、しきい値以上の場合はゼロ以外の終了コードを返します。

husk ci                           # exit 1 on high+ findings (see JSON output below)

環境変数

husk はいくつかの環境変数を読み取ります。

コマンドリファレンス

1 つのバイナリに、多数のサブコマンドが用意されています。各コマンドのすべてのフラグを確認するには、husk <command> --help を実行してください。

• husk scan：今すぐスキャンし、検出結果レポートを表示します
• husk status：再スキャンせずに、前回のスキャンのレポートを表示します
• husk tui：最新のスキャン結果を対話型ターミナル UI で開きます
• husk web：最新のスキャン結果をローカルの Web UI で提供します
• husk check：1 つのパッケージのマルウェア／脆弱性に関する判定を照会します
• husk ci：スキャンしてビルドを判定します。しきい値以上の場合は終了コード 1 を返します
• husk fix：最新のスキャン結果に基づいて修正を計画します。--apply を指定すると書き込みます
• husk init：コミット対象の .husk/policy.toml プロジェクトポリシーを作成します
• husk approve：許可／ブロック／抑制の判断をポリシーに記録します
• husk policy：有効なプロジェクトポリシーとその件数を表示します
• husk ledger：個人の信頼台帳を表示または検証します
• husk daemon：一定間隔でスキャンし、前回の実行以降に新たに検出された項目を報告します
• husk login：husk アカウントにサインインします（近日公開）
• husk logout：このマシンに保存されている認証情報を削除します
• husk account：サインイン中のアカウントとマシンのリンクを表示します
• husk sync：遡及アラートを受け取るため、前回のスキャンのインベントリをアップロードします
• husk alerts：このアカウントの遡及アラートを一覧表示します
• husk telemetry：匿名テレメトリーのオプトインを管理します（デフォルトではオフ）
• husk feedback：husk の開発者にフィードバックを送信します
• husk mcp：MCP サーバーを実行するか、AI エージェントに登録します

JSON 出力

複数のコマンドが、スキャンレポート全体を JSON で出力します。husk scan --json、 husk status --json、husk tui --json、および husk ci（常に JSON）です。構造は どのコマンドでも同じで、ローカルキャッシュに保存され、すべての UI で表示されるレポートです。 標準出力にプレーンな JSON を出力します。ページャーも色付けも使わないため、そのまま jq に渡しても安全です。

husk scan --json | jq -r '.findings[].id'                 # every finding id, worst first
test "$(husk status --json | jq .stats.critical)" -eq 0   # fail a script on any critical
husk ci | jq '.providers[] | select(.ok | not)'           # which intel sources had problems

動作の仕組み

• ローカル優先。 スキャンではファイルを読み取り、静的に解析します。husk がスキャン対象を実行することはありません。結果と状態はお使いのマシン上に保持されます。オンラインスキャンで公開アドバイザリーデータベースに送信されるのは、パッケージ座標と CVE ID のみです。
• パッケージのカバレッジ。 検出機能はプラグイン可能なレジストリで、約 68 のパッケージエコシステム（言語のパッケージマネージャー、OS／ディストリビューションのデータベース、AI／エージェント／エディター関連、CI／IaC／コンテナー、CycloneDX／SPDX SBOM）を網羅しています。詳細は src/scan/targets/ を参照してください。
• エクスプロイトを考慮。 CISA KEV と FIRST EPSS の情報を加味し、区別のない CVE リストを並べるのではなく、実際に悪用されている CVE を上位に表示します。
• 蓄積される状態。 リポジトリにコミットした .husk/policy.toml（ブロック／許可、抑制、CI のしきい値）はリポジトリとともに引き継がれます。個人用のハッシュチェーン付き信頼台帳 ~/.husk/ledger.jsonl には、すべての approve が記録されます。どちらもローカルに保存され、内容を確認でき、削除できます。
• エージェント向けに設計。 husk mcp は標準入出力経由で Model Context Protocol サーバーを提供し、AI エージェントが検出結果を読み取り、対象を限定したスキャンを実行できるようにします。husk mcp install <agent> は設定を書き込みます。Model Context Protocol Registry には mcp-name: io.github.husk-security/husk として登録されています。エージェント向けの詳細は AGENTS.md と integrations/ を参照してください。

ソースからビルドする

Cargo と Rust 1.95 以降があれば十分です。

git clone https://github.com/husk-security/husk
cd husk
cargo build --release --no-default-features
./target/release/husk scan /path/to/your/project

localhost の Web UI は web/ にある Vite + React アプリで、デフォルトの web Cargo feature のもと、バイナリに（rust-embed を介して）埋め込まれます。ビルド方法は 2 つあります。いずれかを選んでください。

• フルビルド（デフォルトの feature）。 まずフロントエンドをビルドし、その後コンパイルします。Node が必要なのはこの方法だけです。

  npm --prefix web ci
  npm --prefix web run build      # → web/dist
  cargo build --release           # rust-embed embeds web/dist
  

• CLI/TUI のみ（Node 不要）。 Web UI を完全に除外するため、事前のビルドは不要です。

  cargo build --release --no-default-features
  

web/dist は生成物で、gitignore 対象です。フロントエンドを先にビルドせずに通常の cargo build を実行すると、web feature には web/dist が必要なため、上記の 2 つの方法のいずれかを案内する明確なエラーが表示され、失敗します。

すでに Nix をお使いの場合、flake には同じツールチェーンが固定されています。nix develop でそのツールチェーンを含むシェルを起動でき、nix build .#husk（Web UI を含む）または nix build .#husk-tui（Node 不要）でバイナリを直接ビルドできます。いずれも必須ではありません。

開発者向けドキュメント（モジュール構成、3 つのプラグイン可能なレジストリ、スキャナーの追加方法）は AGENTS.md にあります。

husk自体の脆弱性は、公開のIssueではなく、SECURITY.mdに記載された非公開の窓口から報告してください。

リリースの検証

VERSION="v0.0.1"
TARGET="x86_64-unknown-linux-gnu"          # or aarch64-apple-darwin, etc.
ARCHIVE="husk-${VERSION}-${TARGET}.tar.gz"

# 1. Checksum
sha256sum -c "${ARCHIVE}.sha256"           # macOS: shasum -a 256 -c ...

# 2. cosign signature: pin the workflow identity and the OIDC issuer
cosign verify-blob \
  --bundle "${ARCHIVE}.sigstore.json" \
  --certificate-identity-regexp "^https://github.com/husk-security/husk/\.github/workflows/release\.yml@refs/tags/v" \
  --certificate-oidc-issuer "https://token.actions.githubusercontent.com" \
  "${ARCHIVE}"

# 3. SLSA provenance
gh attestation verify "${ARCHIVE}" --repo husk-security/husk

サポートとライセンス

• ビルドと開発：上記のソースからのビルドとAGENTS.mdをご覧ください。新しい検出機能には、フィクスチャとテストが付属します。
• コントリビューション：ビルドとプルリクエストの手順についてはCONTRIBUTING.mdをご覧ください。
• ヘルプの利用：使い方に関する質問、検出結果の解釈に関する相談、具体的なバグ、機能リクエストは、すべてIssuesで受け付けています。
• セキュリティ：husk自体の脆弱性は、SECURITY.mdに従って非公開で報告してください。公開のIssueは絶対に作成しないでください。
• ライセンス：MIT。