pixi global list

List global environments and packages

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, size

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