list command (winget)
The list command of the winget tool displays a list of the applications currently installed on your computer. The list command will show apps that were installed through the Windows Package Manager as well as apps that were installed by other means.
The list command will also display if an update is available for an app, and you can use the upgrade command to update the app.
The list command also supports filters which can be used to limit your list query.
Aliases
The following aliases are available for this command:
- ls
Usage
winget list [[-q] <query>] [<options>]
Note
If you want to list all apps with available updates use winget upgrade (without any arguments).
Arguments
The following arguments are available.
| Argument | Description |
|---|---|
| -q,--query | The query used to search for an app. |
Note
The query argument is positional. Wild-card style syntax is not supported. This is most often the string of characters you expect to help find the installed package you are searching for.
Options
The options allow you to customize the list experience to meet your needs.
| Option | Description |
|---|---|
| --id | Limits the list to the ID of the application. |
| --name | Limits the list to the name of the application. |
| --moniker | Limits the list to the moniker listed for the application. |
| -s, --source | Restricts the list to the source name provided. Must be followed by the source name. |
| --tag | Filters results by tags. |
| --cmd, --command | Filters results by command specified by the application. |
| -n, --count | Limits the number of apps displayed in one query. |
| -e, --exact | Uses the exact string in the list query, including checking for case-sensitivity. It will not use the default behavior of a substring. |
| --scope | Select installed package scope filter (user or machine). |
| --header | Optional Windows-Package-Manager REST source HTTP header. |
| --authentication-mode | Specify authentication window preference (silent, silentPreferred or interactive). |
| --authentication-account | Specify the account to be used for authentication. |
| --accept-source-agreements | Used to accept the source license agreement, and avoid the prompt. |
| --upgrade-available | Lists only packages which have an upgrade available. |
| -?, --help | Get additional help on this command. |
| --wait | Prompts the user to press any key before exiting. |
| --logs,--open-logs | Open the default logs location. |
| --verbose, --verbose-logs | Used to override the logging setting and create a verbose log. |
| --nowarn,--ignore-warnings | Suppresses warning outputs. |
| --disable-interactivity | Disable interactive prompts. |
| --proxy | Set a proxy to use for this execution. |
| --no-proxy | Disable the use of proxy for this execution. |
Example queries
The following example lists a specific version of an application.
The following example lists all application by ID from a specific source.
The following example limits the output of list to 9 apps.
List with update
As stated above, the list command allows you to see what apps you have installed that have updates available.
In the image below, you will notice the preview version of Terminal has an update available.
The list command will show not only the update version available, but the source that the update is available from.
If there are no updates available, list will only show you the currently installed version and the update column will not be displayed.
Windows developer