仓库原始内容
按源仓库内容呈现，保留标题、案例、代码、表格、链接以及原文引用的演示图片。
Cloud CLI: Projects Commands
Execute mcloud projects commands to manage Cloud projects.
Constraints
projects deleteis irreversible — removes all associated environments, deployments, and resources. Always confirm the project ID/handle before deleting.- Use
--yeswithdeletein 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.
bash
mcloud projects list --organization <org-id> --jsonOptions:
-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.
bash
mcloud projects get <project-id-or-handle> --organization <org-id> --jsonArguments:
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.
bash
mcloud projects delete <project-id-or-handle> \
--organization <org-id> \
--yesArguments:
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
bash
# 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