hwipit/plugin

ユーザーのために Hwip をセットアップします。セットアップ全体は、CLI をインストールして hwip install を実行するだけです。このスキルの残りの部分は確認作業です。

セットアップ

npm install -g @hwip/cli
hwip install

インストーラーは対話形式（ブラウザでのサインイン + エージェント選択）なので、あなたの Bash ツールではなく、ユーザー自身のターミナルで実行する必要があります。ユーザーに実行してもらってください — Claude Code セッション内では ! プレフィックスを付けて入力できます：

! npm install -g @hwip/cli && hwip install

グローバルインストールしてください。npx ではありません。 hwip cc（スマートフォンからセッションを操作）は hwip が PATH 上にある必要があります。また、インストーラーが書き込むエージェントフック（このプラグインのフックや MCP サーバーなど）は command -v hwip || npx … となっています。グローバルバイナリーを使用すると、通知やセッション起動のたびに npx のコールドスタートをスキップできます。通知のみの設定でスマートフォンからの操作が不要な場合は npx -y @hwip/cli install でも動作しますが、デフォルトではグローバルインストールを推奨します。

hwip install の動作：

• まっさらなマシン：ブラウザのサインイン画面を開きます。Web アプリは API キーとインタラクティブフックを 自動的にペアとして 発行します — 設定画面からキーをコピーする必要はありません。CLI はすべて（apiKey、hookId、baseUrl、wsUrl）を ~/.hwip/config.json に保存します。
• 既にサインイン済み：保存された認証情報を保持し、エージェント統合を（再）インストールするだけです。何度実行しても安全です。
• 検出されたすべてのエージェント（Claude Code、Gemini CLI、Codex CLI、Cursor、…）に対してフック/MCP をインストールします。

確認（ユーザーが完了したと言った後）

1. hwip verify（または npx -y @hwip/cli verify）— API キーとフックが設定されていることを報告する必要があります。cat ~/.hwip/config.json は絶対に行わないでください。API キーが含まれており、表示するとキーがトランスクリプトに残ります。
2. テストプッシュを送信します：hwip_notify を使用するか、以下のコマンドを実行します： hwip notify --title "Hwip 接続完了 ✅"
3. スマートフォンが振動したら完了です。ユーザーにエージェントセッションを再起動するように伝えてください。SessionStart フックがリモートコントロールのルールを注入します。

ルール — 古い手動フローを再導入しないこと

• 唯一の情報源：~/.hwip/config.json。すべての Hwip コンポーネント（CLI、MCP サーバー、プラグインフック）はこれを読み取ります。HWIP_API_KEY / HWIP_HOOK_ID を ~/.zshrc、~/.bashrc、~/.claude/settings.json に追加しないでください — シェルのエクスポートは不要であり、ずれが生じる可能性のある第二のコピーを作成します。
• 環境変数は 高度なオーバーライド（マルチアカウント、CI）としてのみ存在します。通常のセットアップ中に提案しないでください。
• マシンがヘッドレス（下記参照）でない限り、Web アプリでキーやフックを手動で作成する手順をユーザーに案内しないでください。

ヘッドレスマシン（ブラウザなし）

ブラウザが使える任意のマシンでサインインしてください。ユーザーはそのマシンの ~/.hwip/config.json から2つの値（apiKey、hookId）を自分で読み取ります — ファイルをセッション内に出力しないでください。API キーが含まれています。ヘッドレスマシンでは、ユーザーが自分のターミナルで以下を実行します（あなたが実行すると、キーがトランスクリプトに残ります）：

npm install -g @hwip/cli
hwip install --key ak_... --hook hook_...

問題が発生した場合

hwip_ask 403 Forbidden — キーとフックのペアリングが古い可能性があります。hwip install を再実行してください。新しいサインインで一貫性のあるペアが発行されます。

通知が届かない — command -v jq（フックは jq を必要とします：brew install jq / apt install jq）、およびスマートフォンアプリがブラウザのサインインに使用したものと同じアカウントでサインインしていることを確認してください。

hwip_ask がタイムアウトする — スマートフォンアプリは開いていますか？タイムアウト（デフォルト 300 秒）内に応答しましたか？ hwip verify でインストールの健全性を確認できます。

config.json がない、または破損している — hwip install を再実行してください。ファイルが上書きされます。