Command cheat sheet¶
Every command links to its page in the Pixi documentation.
Workspace¶
| Command | What it does |
|---|---|
pixi init |
Create a pixi.toml in the current directory |
pixi workspace channel add <channel> |
Add a channel |
pixi workspace platform add <platform> |
Add a platform |
pixi add <package> |
Add a dependency and update the lockfile |
pixi add --pypi <package> |
Add a dependency from PyPI |
pixi remove <package> |
Remove a dependency |
Running things¶
| Command | What it does |
|---|---|
pixi run <task> |
Run a task from [tasks] |
pixi run <command> |
Run any command inside the environment |
pixi shell |
Open a shell with the environment activated |
pixi run -e <env> <task> |
Run in a specific environment |
pixi task list |
List the available tasks |
Environments and locking¶
| Command | What it does |
|---|---|
pixi install |
Install the environment from the lockfile |
pixi lock |
Update the lockfile without installing |
pixi lock --check |
Fail if the lockfile is out of date. Use this in CI |
pixi update <package> |
Update one package to the newest allowed version |
pixi list |
Show what is installed |
pixi tree <package> |
Show why a package is in the environment |
pixi clean |
Remove .pixi/ |
Inspecting¶
| Command | What it does |
|---|---|
pixi info |
Versions, cache locations, and the virtual packages your machine reports (field by field) |
pixi search <package> |
Search the configured channels |
pixi list --platform <platform> |
What would be installed on another platform |
Building¶
| Command | What it does |
|---|---|
pixi build |
Build the [package] in this workspace into a .conda file |
pixi publish |
Build and upload the package to a channel |
The ROS build backend that turns a package.xml into a conda package is
pixi-build-ros.
RoboStack channels¶
| ROS distribution | Repository | Channel |
|---|---|---|
| Rolling | GitHub repo | Build channels |
| Lyrical | GitHub repo | Build channels |
| Kilted | GitHub repo | Build channels |
| Jazzy (LTS) | GitHub repo | Build channels |
| Humble (LTS) | GitHub repo | Build channels |
| Noetic (ROS 1) | GitHub repo | Build channels |
Reading further¶
| Topic | Page |
|---|---|
Every field in pixi.toml |
Manifest reference |
| All commands and flags | CLI reference |
| What the lockfile guarantees | Lockfile |
| Features, environments, and solve groups | Multi environment |
| Task dependencies, inputs, and outputs | Advanced tasks |
| Building your own ROS packages | Build a ROS package |
| Pixi for robotics, start to finish | Robotics and the ROS 2 tutorial |