settings.json

hooks.Setup

型array

リポジトリの初期化(--init)やメンテナンス(--maintenance)中に実行されるフック。

使い方・用途

  • プロジェクトのセットアップ時や CI 環境での実行時に、一度限りの依存関係のインストールや環境準備スクリプトを自動実行します。
英語原文(公式ドキュメントより)

UNDOCUMENTED. Hooks that run during repository initialization (--init, --init-only) or maintenance (--maintenance)

関連ドキュメント

関連する変更履歴

v2.1.305(1件)

Added
[VSCode] SessionStart または Setup フックの実行中に、スクリーンリーダー向けアナウンス付きの「Running start-up hooks」スピナー状態を追加した。
英語原文を表示
[VSCode] Added a "Running start-up hooks" spinner status, with a screen reader announcement, while SessionStart or Setup hooks run

変更後

VSCode 拡張で SessionStart や Setup フックの実行中に、画面にスピナーの状態が表示され、スクリーンリーダーにも読み上げが通知されるため、視覚に頼らず処理の進行状況を把握できる。

関連ドキュメント

v2.1.239(1件)

Changed
長時間実行される SessionStart や Setup フックの実行中もリモートセッションがキープアライブを送り続けるようにし、フックの途中でコンテナがアイドル状態として回収されないようにした
英語原文を表示
Remote sessions keep sending keep-alives while a long SessionStart or Setup hook runs, so the container is not idle-reaped mid-hook

変更後

リモートセッションで、時間のかかる SessionStart フックや Setup フックの実行中もセッションがアイドル扱いで切断されなくなった

関連ドキュメント

v2.1.199(1件)

Fixed
SessionStart、Setup、およびSubagentStartフックが終了コード2で終了する際、標準エラー出力(stderr)を隠してしまう問題を修正し、内容がトランスクリプトに表示されるようにしました。
英語原文を表示
Fixed SessionStart, Setup, and SubagentStart hooks silently hiding stderr when exiting with code 2 — the error is now shown in the transcript

変更後

フックの設定やスクリプトに問題がある場合でも、迅速に原因を把握して修正できます。

関連ドキュメント

v2.1.142(1件)

Improved
特定のフックイベントで不適切なフックタイプを設定した場合のエラーメッセージを改善
英語原文を表示
Improved hook configuration error: configuring a prompt- or agent-type hook for SessionStart/Setup/SubagentStart now shows a clear "use a command-type hook instead" error

変更後

フック機能の高度なカスタマイズを行う際に、設定ミスを迅速に自己解決できるようになります。

関連ドキュメント

v2.1.10(1件)

Added
リポジトリのセットアップやメンテナンス操作のための、--init、--init-only、または--maintenanceフラグから呼び出し可能な新しい Setup フックイベントを追加しました。
英語原文を表示
Added new Setup hook event that can be triggered via --init, --init-only, or --maintenance CLI flags for repository setup and maintenance operations

関連ドキュメント