pixi global list

Lists global environments with their dependencies and exposed commands. Can also display all packages within a specific global environment.

Usage

pixi global list [OPTIONS] [REGEX]

Alias: pixi g list, pixi g ls

Arguments

REGEX

string

List only packages matching a regular expression.Without regex syntax, it acts like a contains filter.

Options

--environment

string

List all packages in a specific environment, with output similar to pixi list.

--sort-by

string

default:"name"

Sorting strategy for the package table of an environment.Options: name, sizeRequires --environment.

--json

boolean

Output in JSON format.

Examples

List all global environments

pixi global list

Output:

python (Python 3.12.0)
  Packages: python, pip
  Exposed: python, python3, pip

jupyter (Jupyter Lab 4.0.9)
  Packages: jupyter, ipython, polars
  Exposed: jupyter, jupyter-lab, ipython

starship (Starship 1.17.0)
  Packages: starship
  Exposed: starship

List environments matching a pattern

pixi global list py

Shows only environments containing “py” in their name or packages.

List packages in a specific environment

pixi global list --environment python

Output (similar to pixi list):

Package    Version    Build          Size     Kind   Source
python     3.12.0     h1234567_0     45.2 MB  conda  conda-forge
pip        23.3.1     pyhd8ed1ab_0   2.1 MB   conda  conda-forge
setuptools 69.0.2     pyhd8ed1ab_0   500 KB   conda  conda-forge

Sort packages by size

pixi global list --environment python --sort-by size

Output as JSON

pixi global list --json

Display Format

All Environments

When listing all environments:

Yellow: Exposed binaries (executables available in your PATH)
Green: Explicit package dependencies
Blue: Package versions
Cyan: Environment names

Per Environment

When using --environment:

Green: Explicitly installed packages (bold)
Regular text: Transitive dependencies

JSON Output Format

All Environments

[
  {
    "name": "python",
    "packages": [
      {
        "name": "python",
        "version": "3.12.0",
        "build": "h1234567_0"
      }
    ],
    "exposed": ["python", "python3", "pip"]
  }
]

Specific Environment

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

Use Cases

Check What’s Installed

pixi global list

Find Available Commands

pixi global list | grep "Exposed:"

Audit a Specific Environment

pixi global list --environment python

Export Environment Information

pixi global list --environment python --json > python-env.json

Check if Environment is in Sync

Pixi will warn you if environments are out of sync:

pixi global list
# Warning: The environments are not in sync with the manifest
# Run: pixi global sync

Filtering

By Name

pixi global list python

Shows environments with “python” in the name or package list.

By Regex

pixi global list "^py.*"

Shows environments starting with “py”.

Environment Status

The list command will warn you if:

Environments are out of sync with the manifest
An environment needs to be synced

To fix:

pixi global sync

Sorting Options

By Name (default)

pixi global list --environment myenv --sort-by name

By Size

pixi global list --environment myenv --sort-by size

Sorting options only work with the --environment flag.

Understanding the Output

Exposed vs Installed

Installed packages: All packages in the environment
Exposed executables: Commands available in your PATH

Example:

pixi global install jupyter --with matplotlib

Output:

jupyter
  Packages: jupyter, matplotlib, ...
  Exposed: jupyter, jupyter-lab  # matplotlib commands NOT exposed

Explicit vs Transitive

When using --environment:

Explicit (bold green): Packages you installed
Transitive: Dependencies of those packages

Use pixi g ls as a shorthand for pixi global list.

Complete Workflow

# Install some packages
pixi global install python jupyter starship

# List everything
pixi global list

# Check a specific environment
pixi global list --environment python

# Find large packages
pixi global list --environment python --sort-by size

# Export to JSON
pixi global list --json > global-envs.json

Workspace Commands

Environment Commands

Global Commands

Build Commands

Other Commands

pixi global list

Usage

Arguments

Options

Examples

List all global environments

List environments matching a pattern

List packages in a specific environment

Sort packages by size

Output as JSON

Display Format

All Environments

Per Environment

JSON Output Format

All Environments

Specific Environment

Use Cases

Check What’s Installed

Find Available Commands

Audit a Specific Environment

Export Environment Information

Check if Environment is in Sync

Filtering

By Name

By Regex

Environment Status

Sorting Options

By Name (default)

By Size

Understanding the Output

Exposed vs Installed

Explicit vs Transitive

Complete Workflow

Build docs developers (and LLMs) love

Workspace Commands

Environment Commands

Global Commands

Build Commands

Other Commands

Documentation Index

​Usage

​Arguments

​Options

​Examples

​List all global environments

​List environments matching a pattern

​List packages in a specific environment

​Sort packages by size

​Output as JSON

​Display Format

​All Environments

​Per Environment

​JSON Output Format

​All Environments

​Specific Environment

​Use Cases

​Check What’s Installed

​Find Available Commands

​Audit a Specific Environment

​Export Environment Information

​Check if Environment is in Sync

​Filtering

​By Name

​By Regex

​Environment Status

​Sorting Options

​By Name (default)

​By Size

​Understanding the Output

​Exposed vs Installed

​Explicit vs Transitive

​Complete Workflow

Build docs developers (and LLMs) love

Usage

Arguments

Options

Examples

List all global environments

List environments matching a pattern

List packages in a specific environment

Sort packages by size

Output as JSON

Display Format

All Environments

Per Environment

JSON Output Format

All Environments

Specific Environment

Use Cases

Check What’s Installed

Find Available Commands

Audit a Specific Environment

Export Environment Information

Check if Environment is in Sync

Filtering

By Name

By Regex

Environment Status

Sorting Options

By Name (default)

By Size

Understanding the Output

Exposed vs Installed

Explicit vs Transitive

Complete Workflow