conda-global

Global tool installation for conda — install CLI tools into isolated environments and make them available on PATH via trampolines.

Overview

conda-global lets you install command-line tools (like gh, ruff, bat) into isolated conda environments and expose them on your PATH without polluting any project environment. It works like pipx for Python tools or pixi global for the pixi ecosystem, but for the entire conda package ecosystem.

For one-off command execution without installing a persistent PATH tool, use conda-exec, installed separately with conda install -c conda-forge conda-exec:

conda exec ruff check .

Quick start

# Install a tool
conda global install gh

# Use it from anywhere
gh --version

# List installed tools
conda global list

# Update all tools
conda global update

# Remove a tool
conda global uninstall gh

How it works

Each tool gets its own isolated conda environment. A small Rust trampoline binary (provided by the conda-trampoline package) acts as a launcher — it reads a JSON config, sets up the environment, and launches the real binary with zero activation overhead.

The manifest lives at ~/.conda/global.toml; environments and trampolines live under ~/.conda/global/. See the docs for details.

Installation

conda install -c conda-forge conda-global

Then add the bin directory to your PATH:

conda global ensurepath

Commands

A standalone cg alias is also available (cg install ruff, etc.).

License

BSD-3-Clause