Polish the tool first-run experience and allow empty multi-select submissions#8487
Merged
Merged
Conversation
…ion in multi-select
Contributor
There was a problem hiding this comment.
Pull request overview
This PR improves the azd tool first-run UX by clarifying the initial messaging, adding explicit feedback when there’s nothing to install, and enabling the recommended-tools multi-select prompt to be submitted with zero selections (opt-in) so the existing “no tools selected” path is reachable.
Changes:
- Add
AllowEmptySelectionto theMultiSelectUX component and gate the “at least one option” validation on it. - Update the tool first-run middleware to allow empty submissions for the recommended-tools prompt and to print a “you’re all set” message when all recommended tools are already installed.
- Bump CLI version to
1.25.4and record the fix in the changelog.
Reviewed changes
Copilot reviewed 5 out of 5 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| cli/version.txt | Updates the CLI version to 1.25.4. |
| cli/azd/pkg/ux/multi_select.go | Introduces opt-in empty-selection submission for MultiSelect via AllowEmptySelection. |
| cli/azd/pkg/azdext/version.go | Syncs azdext SDK Version with cli/version.txt. |
| cli/azd/cmd/middleware/tool_first_run.go | Improves first-run banner wording, allows deselect-all in the recommended-tools prompt, and adds a message when nothing is missing. |
| cli/azd/CHANGELOG.md | Adds a 1.25.4 entry documenting the first-run prompt fix and wording updates. |
vhvb1989
approved these changes
May 29, 2026
Contributor
Author
|
/check-enforcer override |
Collaborator
Azure Dev CLI Install InstructionsInstall scriptsMacOS/Linux
bash: pwsh: WindowsPowerShell install MSI install Standalone Binary
MSI
Documentationlearn.microsoft.com documentationtitle: Azure Developer CLI reference
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Fixes #8491
This PR improves the clarity of the tool first-run experience and makes the underlying multi-select prompt more flexible by allowing users to proceed without selecting any options.
Motivation
Two rough edges in the tool first-run flow prompted these changes:
What changed
The
MultiSelectUX component now supports an opt-inAllowEmptySelectionoption. When enabled, the prompt permits submitting with zero selections instead of forcing at least one. The option defaults tofalse, so all existing callers retain their current behavior.The tool first-run middleware adopts this option for the "Select recommended tools to install" prompt, so users can now intentionally proceed without installing anything and land on the existing "No tools selected" message that points them to
azd tool install.The middleware also now gives explicit feedback when there is nothing to install: if all recommended tools are already present, it prints a grey "All recommended tools are installed. You're all set!" line rather than continuing silently.
Wording changes
Follow-up
Wiring
AllowEmptySelectionthrough the higher-level prompt layers (the shared prompt helpers and the gRPC prompt service used by extensions) is left for a follow-up change.