settings.json

Setup

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

使い方・用途

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

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

関連ドキュメント

関連する変更履歴

v2.1.199(1件)

Fixed
Hooks
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
HooksSettings
特定のフックイベントで不適切なフックタイプを設定した場合のエラーメッセージを改善
英語原文を表示
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

変更前

SessionStart などのイベントにプロンプト型やエージェント型のフックを誤って設定した際、原因の分かりにくいエラーが発生していました。

変更後

「代わりにコマンド型(command-type)フックを使用してください」という明確な解決策を提示するメッセージが表示されるようになりました。

ユーザーへの恩恵

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

関連ドキュメント

v2.1.10(1件)

Added
Hooks
リポジトリのセットアップやメンテナンス操作のための、--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

関連ドキュメント