Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/prefix-dev/pixi/llms.txt

Use this file to discover all available pages before exploring further.

Lists the packages installed in the current workspace environment. Explicit dependencies (packages directly specified in the manifest) are highlighted.

​
Usage

pixi list [OPTIONS] [REGEX]
Alias: pixi ls

​
Arguments

​
REGEX
string
List only packages matching a regular expression.

​
Options

​
--manifest-path
path
The path to the pixi.toml or pyproject.toml file.
​
--environment
string
The environment to list packages for. Defaults to the default environment.
​
--platform
string
The platform to list packages for. Defaults to the current platform.
​
--json
boolean
Output in JSON format.Alias: --json-pretty
​
--sort-by
string
default:"name"
Sorting strategy for packages.Options: name, size, kindCannot be used with --json.
​
--fields
string
default:"name,version,build,size,kind,source"
Select which fields to display and in what order (comma-separated).Available fields:
  • name - Package name
  • version - Package version
  • build - Build string
  • build-number - Build number
  • size - Package size
  • kind - Package kind (conda/pypi)
  • source - Package source (channel or URL)
  • license - Package license
  • license-family - License family
  • is-editable - Whether package is editable
  • platform - Target platform
  • arch - Architecture
  • subdir - Subdirectory
  • url - Package URL
  • file-name - File name
  • md5 - MD5 hash
  • sha256 - SHA256 hash
  • timestamp - Package timestamp
  • noarch - Noarch type
  • requested-spec - Requested specification
  • depends - Dependencies
  • constrains - Constraints
  • track-features - Track features
Cannot be used with --json.
​
--frozen
boolean
Use the lockfile as-is without updating it.
​
--locked
boolean
Check if the lockfile is up-to-date. Errors if the lockfile is out-of-date.
​
--no-install
boolean
Don’t install the environment before listing packages.
​
--explicit
boolean
Only list packages that are explicitly defined in the workspace.

​
Examples

​
List all packages

pixi list
Output: 
Package         Version    Build           Size     Kind   Source
python          3.12.0     h1234567_0      45.2 MB  conda  conda-forge
numpy           1.26.2     py312h123456_0  7.8 MB   conda  conda-forge
requests        2.31.0     pyhd8ed1ab_0    102 KB   conda  conda-forge
Explicit dependencies are shown in bold in the terminal output.

​
Filter packages by name

pixi list python

​
List packages matching a regex

pixi list "^py.*"

​
Sort by size

pixi list --sort-by size

​
List only explicit dependencies

pixi list --explicit

​
Output as JSON

pixi list --json

​
List packages for a specific environment

pixi list --environment production

​
List packages for a different platform

pixi list --platform linux-64

​
Custom field selection

pixi list --fields name,version,license,size

​
List with all available fields

pixi list --fields name,version,build,build-number,size,kind,source,license,platform,url

​
Package Display

​
Color Coding

  • Yellow version numbers: Conda packages
  • Blue version numbers: PyPI packages
  • Bold package names: Explicit dependencies

​
Package Kinds

  • conda - Package from a conda channel
  • pypi - Package from PyPI

​
Editable Packages

Editable packages are marked with (editable) in yellow next to their source: 
my-package  0.1.0  -  100 KB  pypi  file:///path/to/package (editable)

​
JSON Output Format

[
  {
    "name": "python",
    "version": "3.12.0",
    "build": "h1234567_0",
    "size_bytes": 47382912,
    "kind": "Conda",
    "source": "https://conda.anaconda.org/conda-forge",
    "is_explicit": true,
    "license": "Python-2.0",
    "md5": "abc123...",
    "sha256": "def456..."
  }
]

​
Sorting Options

​
By Name (default)

pixi list --sort-by name
Packages are sorted alphabetically.

​
By Size

pixi list --sort-by size
Packages are sorted by file size, smallest to largest.

​
By Kind

pixi list --sort-by kind
Packages are grouped by type (conda/pypi).

​
Use Cases

​
Audit Dependencies

# Check what's installed
pixi list --explicit

# Find large packages
pixi list --sort-by size

​
Export Package List

# Export to JSON
pixi list --json > packages.json

# Export explicit dependencies only
pixi list --explicit --json > dependencies.json

​
Cross-Platform Development

# Check what would be installed on Linux
pixi list --platform linux-64

# Check what would be installed on macOS ARM
pixi list --platform osx-arm64

​
License Compliance

# List all licenses
pixi list --fields name,version,license,license-family
You can use pixi ls as a shorthand for pixi list.

​
Differences from pixi tree

Featurepixi listpixi tree
OutputFlat package listDependency tree
Shows relationshipsNoYes
SortingYesNo
JSON outputYesNo
Field selectionYesNo

Build docs developers (and LLMs) love

Get started for freeTalk to us