はじめに

.NET Aspire CLI のバージョン13系では、以前存在していたホットリロード用の -w オプションが廃止されました。
本記事では、バージョン13.1.2 時点での代替手段としてコンフィグによるホットリロード有効化の方法をまとめます。

以前の挙動と変更点

以前のバージョンでは aspire run -w のように -w オプションを付けることで dotnet watch と同様の変更検知が可能でした。
しかし 2026/03/08 現在、aspire run -h でヘルプを確認するとそのオプションは存在しません。

# Aspire runのヘルプ
> aspire run -h
Description:
  開発モードで Aspire AppHost を実行します。

使用法:
  aspire run [options] [[--] <additional arguments>...]]

オプション:
  --project <project>  Aspire AppHost プロジェクト ファイルへのパス。
  -?, -h, --help       Show help and usage information
  -d, --debug          コンソールへのデバッグ ログを有効にします。
  --non-interactive    Run the command in non-interactive mode, disabling all interactive prompts and spinners
  --wait-for-debugger  デバッガーがアタッチされるまで待ってから、コマンドを実行します。

追加引数:
  Arguments passed to the application that is being run.

解決策：コンフィグでホットリロードを有効化

同様の質問が GitHub の Issue でもされています。

結論として、以下のコマンドでコンフィグを設定することで対応できます。

aspire config set features.defaultWatchEnabled true

実際に試したところ、レイアウト修正・C# コードの修正どちらもホットリロードされることを確認しました。

Aspire CLI の設定値一覧

aspire config set で設定できる項目は以下の通りです。

Setting	Description	説明（AI翻訳）
appHostPath	Path to default AppHost project.	デフォルトの AppHost プロジェクトへのパス。
features.defaultWatchEnabled	Enable watch mode by default for run command.	run コマンドのデフォルトで watch モードを有効にする。
features.dotnetSdkInstallationEnabled	Enable automatic .NET SDK installation.	.NET SDK の自動インストールを有効にする。
features.execCommandEnabled	Enable exec command.	exec コマンドを有効にする。
features.minimumSdkCheckEnabled	Enforce minimum SDK version.	最低 SDK バージョンを強制する。
features.orphanDetectionWithTimestampEnabled	Use timestamp-based orphan detection.	タイムスタンプベースの孤立プロセス検出を使用する。
features.packageSearchDiskCachingEnabled	Cache package search results on disk.	パッケージ検索結果をディスクにキャッシュする。
features.runningInstanceDetectionEnabled	Enable detection of already running instances.	既に起動中のインスタンスの検出を有効にする。
features.showAllTemplates	Show all templates including experimental ones.	試験的なものを含むすべてのテンプレートを表示する。
features.showDeprecatedPackages	Show deprecated packages.	非推奨のパッケージを表示する。
features.stagingChannelEnabled	Use staging channel packages.	ステージングチャンネルのパッケージを使用する。
features.updateNotificationsEnabled	Show update notifications.	アップデート通知を表示する。

まとめ

Aspire CLIを用いて開発をしている際にdotnet watchのようなホットリロードを行うための設定を紹介しました。

他の設定だとfeatures.updateNotificationsEnabledとかも便利かもしれないです。

この記事が皆様のコーディングライフの助けになれば幸いです。

参考