DocsCLI
Packages and folders
List the packages in a source workspace with as2 list, and jump to their folders with as2 cd.
List
as2 list lists the ROS 2 packages in the workspace's src folder, Aerostack2's and any others,
sorted by name:
as2 list
as2 list -v| Flag | What it does |
|---|---|
-v, --verbose | Shows each package's folder |
-p, --plain | Prints without colors |
--projects | Lists the downloaded projects instead of the packages |
cd
as2 cd moves the shell to a folder by name. With no name, it goes to the Aerostack2 folder:
as2 cd
as2 cd motion_controller
as2 cd projectsA name is looked up in this order:
projects, the folder where the example projects are downloaded.- A downloaded project with that name.
- A package with that exact name.
- A package with
as2_in front of the name, soas2 cd corereachesas2_core.
A name that matches nothing prints package <name> not found, and the shell stays where it was.
In bash, tab completes package names after as2 build, as2 test and as2 clean, and package and
project names after as2 cd. The names are read when setup_env.bash is sourced, so source it
again to complete packages and projects added since.
Last updated on November 3, 2026