Normalize CLI command descriptions for consistency

src/Aspire.Cli/Commands/DeployCommand.cs

@@ -26,7 +26,7 @@ public DeployCommand(IDotNetCliRunner runner, IInteractionService interactionSer
     {
         _clearCacheOption = new Option<bool>("--clear-cache")
         {
-            Description = "Clear the deployment cache associated with the current environment and do not save deployment state"
+            Description = DeployCommandStrings.ClearCacheOptionDescription
         };
         Options.Add(_clearCacheOption);
     }

src/Aspire.Cli/Commands/InitCommand.cs

@@ -119,7 +119,7 @@ public InitCommand(
 
         _languageOption = new Option<string?>("--language")
         {
-            Description = "The programming language for the AppHost (csharp, typescript)"
+            Description = InitCommandStrings.LanguageOptionDescription
         };
         Options.Add(_languageOption);
     }

src/Aspire.Cli/Commands/McpCallCommand.cs

@@ -27,17 +27,17 @@ internal sealed class McpCallCommand : BaseCommand
 
     private static readonly Argument<string> s_resourceArgument = new("resource")
     {
-        Description = "The name of the resource that exposes the MCP tool."
+        Description = McpCommandStrings.CallCommand_ResourceArgumentDescription
     };
 
     private static readonly Argument<string> s_toolArgument = new("tool")
     {
-        Description = "The name of the MCP tool to call."
+        Description = McpCommandStrings.CallCommand_ToolArgumentDescription
     };
 
     private static readonly Option<string?> s_inputOption = new("--input", "-i")
     {
-        Description = "JSON input to pass to the tool."
+        Description = McpCommandStrings.CallCommand_InputOptionDescription
     };
 
     private static readonly OptionWithLegacy<FileInfo?> s_appHostOption = new("--apphost", "--project", SharedCommandStrings.AppHostOptionDescription);
@@ -50,7 +50,7 @@ public McpCallCommand(
         CliExecutionContext executionContext,
         AspireCliTelemetry telemetry,
         ILogger<McpCallCommand> logger)
-        : base("call", "Call an MCP tool on a running resource.", features, updateNotifier, executionContext, interactionService, telemetry)
+        : base("call", McpCommandStrings.CallCommand_Description, features, updateNotifier, executionContext, interactionService, telemetry)
     {
         _interactionService = interactionService;
         _connectionResolver = new AppHostConnectionResolver(backchannelMonitor, interactionService, executionContext, logger);

src/Aspire.Cli/Commands/McpToolsCommand.cs

@@ -28,7 +28,7 @@ internal sealed class McpToolsCommand : BaseCommand
     private static readonly OptionWithLegacy<FileInfo?> s_appHostOption = new("--apphost", "--project", SharedCommandStrings.AppHostOptionDescription);
     private static readonly Option<OutputFormat> s_formatOption = new("--format")
     {
-        Description = "Output format (Table or Json)."
+        Description = McpCommandStrings.ToolsCommand_FormatOptionDescription
     };
 
     public McpToolsCommand(
@@ -39,7 +39,7 @@ public McpToolsCommand(
         CliExecutionContext executionContext,
         AspireCliTelemetry telemetry,
         ILogger<McpToolsCommand> logger)
-        : base("tools", "List MCP tools exposed by running resources.", features, updateNotifier, executionContext, interactionService, telemetry)
+        : base("tools", McpCommandStrings.ToolsCommand_Description, features, updateNotifier, executionContext, interactionService, telemetry)
     {
         _interactionService = interactionService;
         _connectionResolver = new AppHostConnectionResolver(backchannelMonitor, interactionService, executionContext, logger);

src/Aspire.Cli/Commands/PipelineCommandBase.cs

@@ -42,17 +42,17 @@ internal abstract class PipelineCommandBase : BaseCommand
 
     protected static readonly Option<string?> s_logLevelOption = new("--log-level")
     {
-        Description = "Set the minimum log level for pipeline logging (trace, debug, information, warning, error, critical). The default is 'information'."
+        Description = SharedCommandStrings.PipelineLogLevelOptionDescription
     };
 
     protected static readonly Option<bool> s_includeExceptionDetailsOption = new("--include-exception-details")
     {
-        Description = "Include exception details (stack traces) in pipeline logs."
+        Description = SharedCommandStrings.PipelineIncludeExceptionDetailsOptionDescription
     };
 
     protected static readonly Option<string?> s_environmentOption = new("--environment", "-e")
     {
-        Description = "The environment to use for the operation. The default is 'Production'."
+        Description = SharedCommandStrings.PipelineEnvironmentOptionDescription
     };
 
     protected static readonly Option<bool> s_noBuildOption = new("--no-build")

src/Aspire.Cli/Commands/RenderCommand.cs

@@ -42,7 +42,7 @@ public RenderCommand(
         CliExecutionContext executionContext,
         IInteractionService interactionService,
         AspireCliTelemetry telemetry)
-        : base("render", "Smoke test CLI rendering.", features, updateNotifier, executionContext, interactionService, telemetry)
+        : base("render", "Smoke test CLI rendering", features, updateNotifier, executionContext, interactionService, telemetry)
     {
         Hidden = true;
     }

src/Aspire.Cli/Commands/SetupCommand.cs

@@ -24,7 +24,7 @@ internal sealed class SetupCommand : BaseCommand
 
     private static readonly Option<bool> s_forceOption = new("--force")
     {
-        Description = "Force extraction even if the layout already exists."
+        Description = "Force extraction even if the layout already exists"
     };
 
     public SetupCommand(
@@ -34,7 +34,7 @@ public SetupCommand(
         CliExecutionContext executionContext,
         IInteractionService interactionService,
         AspireCliTelemetry telemetry)
-        : base("setup", "Extract the embedded bundle to set up the Aspire CLI runtime.", features, updateNotifier, executionContext, interactionService, telemetry)
+        : base("setup", "Extract the embedded bundle to set up the Aspire CLI runtime", features, updateNotifier, executionContext, interactionService, telemetry)
     {
         // Hidden: the setup command is an implementation detail used by install scripts.
         Hidden = true;

src/Aspire.Cli/Commands/UpdateCommand.cs

@@ -34,7 +34,7 @@ internal sealed class UpdateCommand : BaseCommand
     private static readonly OptionWithLegacy<FileInfo?> s_appHostOption = new("--apphost", "--project", UpdateCommandStrings.ProjectArgumentDescription);
     private static readonly Option<bool> s_selfOption = new("--self")
     {
-        Description = "Update the Aspire CLI itself to the latest version"
+        Description = UpdateCommandStrings.SelfOptionDescription
     };
     private readonly Option<string?> _channelOption;
     private readonly Option<string?> _qualityOption;

src/Aspire.Cli/Resources/AddCommandStrings.resx

@@ -118,19 +118,19 @@
     <value>System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
   </resheader>
   <data name="Description" xml:space="preserve">
-    <value>Add a hosting integration to the apphost.</value>
+    <value>Add a hosting integration to the apphost</value>
   </data>
   <data name="IntegrationArgumentDescription" xml:space="preserve">
-    <value>The name of the integration to add (e.g. redis, postgres).</value>
+    <value>The name of the integration to add (e.g. redis, postgres)</value>
   </data>
   <data name="ProjectArgumentDescription" xml:space="preserve">
-    <value>The path to the Aspire AppHost project file to add the integration to.</value>
+    <value>The path to the Aspire apphost project file to add the integration to</value>
   </data>
   <data name="VersionArgumentDescription" xml:space="preserve">
-    <value>The version of the integration to add.</value>
+    <value>The version of the integration to add</value>
   </data>
   <data name="SourceArgumentDescription" xml:space="preserve">
-    <value>The NuGet source to use for the integration.</value>
+    <value>The NuGet source to use for the integration</value>
   </data>
   <data name="SearchingForAspirePackages" xml:space="preserve">
     <value>Searching for Aspire integrations...</value>
@@ -173,9 +173,9 @@
     <value>Use pre-release packages</value>
   </data>
   <data name="StoppedRunningInstance" xml:space="preserve">
-    <value>Stopped a running Aspire AppHost instance to allow package modification.</value>
+    <value>Stopped a running Aspire apphost instance to allow package modification.</value>
   </data>
   <data name="UnableToStopRunningInstances" xml:space="preserve">
-    <value>Unable to stop one or more running Aspire AppHost instances. Please stop the application and try again.</value>
+    <value>Unable to stop one or more running Aspire apphost instances. Please stop the application and try again.</value>
   </data>
 </root>

src/Aspire.Cli/Resources/AgentCommandStrings.resx

@@ -61,13 +61,13 @@
     <value>System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
   </resheader>
   <data name="Description" xml:space="preserve">
-    <value>Manage AI agent specific setup.</value>
+    <value>Manage AI agent environment configuration</value>
   </data>
   <data name="McpCommand_Description" xml:space="preserve">
-    <value>Start the MCP (Model Context Protocol) server.</value>
+    <value>Start the MCP (Model Context Protocol) server</value>
   </data>
   <data name="InitCommand_Description" xml:space="preserve">
-    <value>Initialize agent environment configuration for detected agents.</value>
+    <value>Initialize agent environment configuration for detected agents</value>
   </data>
   <data name="DeprecatedConfigUpdate_Description" xml:space="preserve">
     <value>Update {0} config to use new 'agent mcp' command</value>

src/Aspire.Cli/Resources/CacheCommandStrings.resx

@@ -61,10 +61,10 @@
     <value>System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
   </resheader>
   <data name="Description" xml:space="preserve">
-    <value>Manage disk cache for CLI operations.</value>
+    <value>Manage disk cache for CLI operations</value>
   </data>
   <data name="ClearCommand_Description" xml:space="preserve">
-    <value>Clear all cache entries.</value>
+    <value>Clear all cache entries</value>
   </data>
   <data name="CacheCleared" xml:space="preserve">
     <value>Cache cleared successfully.</value>

src/Aspire.Cli/Resources/CertificatesCommandStrings.resx

@@ -61,16 +61,16 @@
     <value>System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
   </resheader>
   <data name="Description" xml:space="preserve">
-    <value>Manage HTTPS development certificates.</value>
+    <value>Manage HTTPS development certificates</value>
   </data>
   <data name="CleanDescription" xml:space="preserve">
-    <value>Remove all HTTPS development certificates.</value>
+    <value>Remove all HTTPS development certificates</value>
   </data>
   <data name="CleanCancelled" xml:space="preserve">
     <value>Certificate clean operation was cancelled by the user.</value>
   </data>
   <data name="TrustDescription" xml:space="preserve">
-    <value>Trust the HTTPS development certificate, creating one if necessary.</value>
+    <value>Trust the HTTPS development certificate, creating one if necessary</value>
   </data>
   <data name="CleanProgress" xml:space="preserve">
     <value>Cleaning development certificates (may require elevated permissions)...</value>

src/Aspire.Cli/Resources/ConfigCommandStrings.resx

@@ -107,25 +107,25 @@
     <value>System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
   </resheader>
   <data name="Description" xml:space="preserve">
-    <value>Manage CLI configuration including feature flags.</value>
+    <value>Manage CLI configuration including feature flags</value>
   </data>
   <data name="GetCommand_Description" xml:space="preserve">
-    <value>Get a configuration value.</value>
+    <value>Get a configuration value</value>
   </data>
   <data name="GetCommand_KeyArgumentDescription" xml:space="preserve">
-    <value>The configuration key to retrieve.</value>
+    <value>The configuration key to retrieve</value>
   </data>
   <data name="SetCommand_Description" xml:space="preserve">
-    <value>Set a configuration value.</value>
+    <value>Set a configuration value</value>
   </data>
   <data name="SetCommand_KeyArgumentDescription" xml:space="preserve">
-    <value>The configuration key to set.</value>
+    <value>The configuration key to set</value>
   </data>
   <data name="SetCommand_ValueArgumentDescription" xml:space="preserve">
-    <value>The configuration value to set.</value>
+    <value>The configuration value to set</value>
   </data>
   <data name="SetCommand_GlobalArgumentDescription" xml:space="preserve">
-    <value>Set the configuration value globally in $HOME/.aspire/settings.json instead of the local settings file.</value>
+    <value>Set the configuration value globally in $HOME/.aspire/settings.json instead of the local settings file</value>
   </data>
   <data name="ConfigurationKeySetLocally" xml:space="preserve">
     <value>Configuration '{0}' set to '{1}' locally.</value>
@@ -136,10 +136,10 @@
     <comment>{0} is the key, {1} is the value</comment>
   </data>
   <data name="ListCommand_Description" xml:space="preserve">
-    <value>List all configuration values.</value>
+    <value>List all configuration values</value>
   </data>
   <data name="ListCommand_AllOptionDescription" xml:space="preserve">
-    <value>Show all available features that can be configured.</value>
+    <value>Show all available features that can be configured</value>
   </data>
   <data name="ListCommand_AllFeaturesHint" xml:space="preserve">
     <value>Run 'aspire config list --all' to see all available feature flags.</value>
@@ -148,13 +148,13 @@
     <value>No configuration values found.</value>
   </data>
   <data name="DeleteCommand_Description" xml:space="preserve">
-    <value>Delete a configuration value.</value>
+    <value>Delete a configuration value</value>
   </data>
   <data name="DeleteCommand_KeyArgumentDescription" xml:space="preserve">
-    <value>The configuration key to delete.</value>
+    <value>The configuration key to delete</value>
   </data>
   <data name="DeleteCommand_GlobalArgumentDescription" xml:space="preserve">
-    <value>Delete the configuration value from the global $HOME/.aspire/settings.json instead of the local settings file.</value>
+    <value>Delete the configuration value from the global $HOME/.aspire/settings.json instead of the local settings file</value>
   </data>
   <data name="ConfigurationKeyDeletedLocally" xml:space="preserve">
     <value>Configuration '{0}' deleted locally.</value>
@@ -205,10 +205,10 @@
     <value>No global configuration found.</value>
   </data>
   <data name="InfoCommand_Description" xml:space="preserve">
-    <value>Display configuration file paths and available features.</value>
+    <value>Display configuration file paths and available features</value>
   </data>
   <data name="InfoCommand_JsonOptionDescription" xml:space="preserve">
-    <value>Output information in JSON format.</value>
+    <value>Output information in JSON format</value>
   </data>
   <data name="InfoCommand_LocalSettingsPath" xml:space="preserve">
     <value>Local settings path</value>

src/Aspire.Cli/Resources/DeployCommandStrings.resx

@@ -118,10 +118,10 @@
     <value>System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
   </resheader>
   <data name="Description" xml:space="preserve">
-    <value>Deploy an apphost to its deployment targets. (Preview)</value>
+    <value>Deploy an apphost to its deployment targets (Preview)</value>
   </data>
   <data name="OutputPathArgumentDescription" xml:space="preserve">
-    <value>The optional output path for deployment artifacts.</value>
+    <value>The optional output path for deployment artifacts</value>
   </data>
   <data name="DeploymentCanceled" xml:space="preserve">
     <value>The deployment was canceled.</value>
@@ -132,4 +132,7 @@
   <data name="OperationFailedPrefix" xml:space="preserve">
     <value>DEPLOYMENT FAILED</value>
   </data>
+  <data name="ClearCacheOptionDescription" xml:space="preserve">
+    <value>Clear the deployment cache associated with the current environment and do not save deployment state</value>
+  </data>
 </root>

src/Aspire.Cli/Resources/DescribeCommandStrings.resx

@@ -118,16 +118,16 @@
     <value>System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
   </resheader>
   <data name="Description" xml:space="preserve">
-    <value>Describe resources in a running apphost.</value>
+    <value>Describe resources in a running apphost</value>
   </data>
   <data name="FollowOptionDescription" xml:space="preserve">
-    <value>Continuously stream resource state changes.</value>
+    <value>Continuously stream resource state changes</value>
   </data>
   <data name="JsonOptionDescription" xml:space="preserve">
-    <value>Output format (Table or Json).</value>
+    <value>Output format (Table or Json)</value>
   </data>
   <data name="NoAppHostFound" xml:space="preserve">
-    <value>No AppHost project found.</value>
+    <value>No apphost project found.</value>
   </data>
   <data name="ResourceArgumentDescription" xml:space="preserve">
     <value>The name of the resource to display. If not specified, all resources are shown.</value>

src/Aspire.Cli/Resources/DoCommandStrings.resx

@@ -118,10 +118,10 @@
     <value>System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
   </resheader>
   <data name="Description" xml:space="preserve">
-    <value>Execute a specific pipeline step and its dependencies. (Preview)</value>
+    <value>Execute a specific pipeline step and its dependencies (Preview)</value>
   </data>
   <data name="OutputPathArgumentDescription" xml:space="preserve">
-    <value>The optional output path for artifacts.</value>
+    <value>The optional output path for artifacts</value>
   </data>
   <data name="OperationCanceled" xml:space="preserve">
     <value>The operation was canceled.</value>
@@ -136,6 +136,6 @@
     <value>Executing pipeline...</value>
   </data>
   <data name="StepArgumentDescription" xml:space="preserve">
-    <value>The name of the step to execute.</value>
+    <value>The name of the step to execute</value>
   </data>
 </root>