---
title: pixi list
---
<!--- This file is autogenerated. Do not edit manually! -->
# [pixi](../pixi.md) list

List the packages of the current workspace

--8<-- "docs/reference/cli/pixi/list_extender:description"

## Usage
```
pixi list [OPTIONS] [REGEX]
```

## Arguments
- <a id="arg-<REGEX>" href="#arg-<REGEX>">`<REGEX>`</a>
:  List only packages matching a regular expression

## Options
- <a id="arg---platform" href="#arg---platform">`--platform <PLATFORM>`</a>
:  The platform to list packages for. Defaults to the current platform
- <a id="arg---json" href="#arg---json">`--json`</a>
:  Whether to output in json format
- <a id="arg---sort-by" href="#arg---sort-by">`--sort-by <SORT_BY>`</a>
:  Sorting strategy
<br>**default**: `name`
<br>**options**: `size`, `name`, `kind`
- <a id="arg---fields" href="#arg---fields">`--fields <FIELDS>`</a>
:  Select which fields to display and in what order (comma-separated)
<br>May be provided more than once.
<br>**default**: `name, version, build, size, kind, source`
<br>**options**: `arch`, `build`, `build-number`, `constrains`, `depends`, `file-name`, `is-editable`, `kind`, `license`, `license-family`, `md5`, `name`, `noarch`, `platform`, `requested-spec`, `sha256`, `size`, `source`, `subdir`, `timestamp`, `track-features`, `url`, `version`
- <a id="arg---environment" href="#arg---environment">`--environment (-e) <ENVIRONMENT>`</a>
:  The environment to list packages for. Defaults to the default environment
- <a id="arg---explicit" href="#arg---explicit">`--explicit (-x)`</a>
:  Only list packages that are explicitly defined in the workspace

## Update Options
- <a id="arg---frozen" href="#arg---frozen">`--frozen`</a>
:  Install the environment as defined in the lockfile, doesn't update lockfile if it isn't up-to-date with the manifest file
<br>**env**: `PIXI_FROZEN`
- <a id="arg---locked" href="#arg---locked">`--locked`</a>
:  Check if lockfile is up-to-date before installing the environment, aborts when lockfile isn't up-to-date with the manifest file
<br>**env**: `PIXI_LOCKED`
- <a id="arg---no-install" href="#arg---no-install">`--no-install`</a>
:  Don't modify the environment, only modify the lock-file
<br>**env**: `PIXI_NO_INSTALL`

## Global Options
- <a id="arg---manifest-path" href="#arg---manifest-path">`--manifest-path (-m) <MANIFEST_PATH>`</a>
:  The path to `pixi.toml`, `pyproject.toml`, or the workspace directory
- <a id="arg---workspace" href="#arg---workspace">`--workspace (-w) <WORKSPACE>`</a>
:  Name of the workspace

## Description
List the packages of the current workspace

Highlighted packages are explicit dependencies.


--8<-- "docs/reference/cli/pixi/list_extender:example"
