mcloud-projects

por medusajs

Execute comandos de projetos mcloud para listar, obter ou excluir projetos Cloud. Use ao descobrir projetos, resolver identificadores de projetos por nome ou recuperar…

npx skills add https://github.com/medusajs/medusa-agent-skills --skill mcloud-projects

Baixar ZIP GitHub

225

Cloud CLI: Projects Commands

Execute mcloud projects commands to manage Cloud projects.

Constraints

projects delete is irreversible — removes all associated environments, deployments, and resources. Always confirm the project ID/handle before deleting.
Use --yes with delete in non-interactive contexts (scripts, pipelines, agents).

Commands

projects list

List projects in an organization. If --organization is omitted (and no active context org is set), lists projects across all organizations you have access to, grouped by organization.

mcloud projects list --organization <org-id> --json

Options:

-o/--organization <id> — Organization ID (falls back to active context; if unset, lists across all your organizations)
--json — Output as JSON

projects get

Retrieve a single project by its ID or handle.

mcloud projects get <project-id-or-handle> --organization <org-id> --json

Arguments:

project — Project ID or handle (required)

Options:

-o/--organization <id> — Organization ID (falls back to active context; required)
--json — Output as JSON

projects delete

Delete a project by its ID or handle. Irreversible.

mcloud projects delete <project-id-or-handle> \
  --organization <org-id> \
  --yes

Arguments:

project — Project ID or handle (required)

Options:

-o/--organization <id> — Organization ID (falls back to active context; required)
-y/--yes — Skip confirmation prompt (required in non-interactive mode)
--json — Output as JSON

Project Fields (JSON)

Field	Description
`id`	Project ID
`handle`	URL-safe project handle (used in most commands)
`name`	Display name
`status`	`ready` when healthy
`region`	Deployment region (e.g. `us-east-1`)
`repository`	Linked GitHub repository (`owner/repo`)
`root_path`	Root path within the repository
`organization`	Owning organization (`id`, `name`, `created_at`)
`environments`	Array of associated environments (each may include `storefront_environments`)

Examples

# List all projects in an organization
mcloud projects list --organization org_123 --json

# Set context to a project by name
PROJECT_HANDLE=$(
  mcloud projects list --organization org_123 --json \
    | jq -r '.[] | select(.name == "My Store") | .handle'
)
mcloud use --project "$PROJECT_HANDLE"

# Get project details including environments
mcloud projects get my-store --organization org_123 --json

# List all environment handles for a project
mcloud projects get my-store --organization org_123 --json \
  | jq -r '.environments[].handle'

# Find project handle by name
mcloud projects list --organization org_123 --json \
  | jq -r '.[] | select(.name == "My Store") | .handle'

# Delete a project (irreversible — confirm before running)
mcloud projects delete old-project --organization org_123 --yes