List Catalyst Projects

You can view a list of the Catalyst projects that you have access to in your Catalyst user account, from the CLI. 

To view a list of all your existing Catalyst projects, execute the following command:

$ catalyst project:list

This will display a table with the names and the Project IDs of your existing Catalyst projects.

The base project of the directory from which you executed the command is also specified in the project list. This is the project that you originally initialized in that directory.  

The list also indicates the project that is active in that directory. If the active project is not the directory's base project, the CLI will display an alert about this.

Use a Catalyst Project

Using Catalyst CLI, you can associate a Catalyst project for your working directory. You can add an existing Catalyst project and link it with your directory.  

However, your directory can only be bound and permanently associated with its base project, which is the project you initialized in that directory. Therefore, when you use another project in the directory, the association with that project will only be temporary.

To use a Catalyst project in your working directory, execute the following command from the required directory:

$ catalyst project:use

The CLI will display a list of your existing projects. Select the project that you require, using the arrow keys. Press Enter to confirm your choice. 

Your project will now be added to your working directory and the CLI will display a confirmation message.

You can also execute the catalyst project:use command with the name or the Project ID of that project to use it in the working directory as follows:

$ catalyst project:use [name_or_project_id]

Reset the Active Project

You can clear the temporary active project of your working directory and reset it back to the base project that the directory was initialized with. Resetting the project helps you undo the catalyst project:use command.

To clear the active project in your working directory and reset it to its base project, navigate to the directory and execute the following command:

$ catalyst project:reset