Skip to main content
A command that needs a project works on one project. Which one is decided in a fixed order.

The order

The one higher in the list wins. There are exceptions. For a command whose positional argument is project_id, that project id takes precedence. For other commands, --project overrides project_id in the --input JSON. Without --project, project_id in the --input JSON is used as it is. For a command whose project is optional, EXPL_PROJECT and the default set with expl project use are not used. expl lang also uses an open project when none of the three is set.

Choosing by name

A name must match exactly. If several projects have the same name, expl stops with an error and lists the candidate ids. Use one of those ids.

When the project is not open

If the project is not open in Desktop, expl returns PROJECT_NOT_OPEN. Open it with this command.
Replace <id> with an id from expl project list.