Help

projects Command - Medusa Cloud CLI Reference

In this guide, you'll learn how to manage your Cloud projects using the CLI.

projects list#

List all projects in an organization.

Option	Description	Required	Default
`-o <id>`, `--organization <id>`	The ID of the organization to list projects from.	Yes	Falls back to the organization in the active context, if set.
`--json`	Print the result as JSON instead of formatted text.	No	`false`

Retrieve a single project by its ID or handle. This is useful if you want to get more details about the project, such as its status or region.

Returns the following information:

Option	Description	Required
`project`	The ID or handle of the project to retrieve.	Yes

Option	Description	Required	Default
`-o <id>`, `--organization <id>`	The ID of the organization to get the project from.	Yes	Falls back to the organization in the active context, if set.
`--json`	Print the result as JSON instead of formatted text.	No	`false`

Delete a project by its ID or handle.

Warning: Deleting a project is irreversible and removes all associated environments, deployments, and resources.

Option	Description	Required
`project`	The ID or handle of the project to delete.	Yes

Option	Description	Required	Default
`-o <id>`, `--organization <id>`	The ID of the organization to get the project from.	Yes	Falls back to the organization in the active context, if set.
`-y`, `--yes`	Skip the confirmation prompt. Use this in scripts and pipelines where interactive input is not possible.	No	`false`
`--json`	Print the result as JSON instead of formatted text.	No	`false`

Commands that operate on projects require a project ID or handle. You can either:

Use the interactive selector in mcloud use to set an active project for the current context. Once set, you can omit the --project flag from all subsequent commands;
Or use projects list --json to get machine-readable project data. Pipe the output to jq to extract IDs or handles for use in subsequent commands. This is useful if you want to set the active project through an AI agent, script, or CI/CD pipeline.

For example, to set the first project in the list as the active project:

To set a project by name as the active project:

Once set, you can omit the --project flag from all subsequent commands.

In automated cleanup scripts, use --yes to skip the interactive confirmation prompt:

Warning: Deleting a project is irreversible and removes all associated environments, deployments, and resources.

Terminal
❯mcloud projects delete old-project --yes

Was this guide helpful?