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>]

Image of list command usage

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.

list name command

The following example lists all application by ID from a specific source.

list id with source command

The following example limits the output of list to 9 apps.

list count command

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.

Image of list with update command

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.