// Execute mcloud projects commands to list, get, or delete Cloud projects. Use when discovering projects, resolving project handles by name, or retrieving project details including linked environments.
| name | mcloud-projects |
| description | Execute mcloud projects commands to list, get, or delete Cloud projects. Use when discovering projects, resolving project handles by name, or retrieving project details including linked environments. |
| allowed-tools | Bash(mcloud projects*), Bash(mcloud use*), Bash(jq*) |
Execute mcloud projects commands to manage Cloud projects.
projects delete is irreversible — removes all associated environments, deployments, and resources. Always confirm the project ID/handle before deleting.--yes with delete in non-interactive contexts (scripts, pipelines, agents).List all projects in an organization.
mcloud projects list --organization <org-id> --json
Options:
-o/--organization <id> — Organization ID (falls back to active context; required)--json — Output as JSONRetrieve 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 JSONDelete 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| 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 |
environments | Array of associated environments |
# 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
Execute mcloud authentication and context commands: login, logout, whoami, use, version, and signup. Use when setting up the CLI, switching accounts, verifying auth state, setting the active org/project/environment context, or checking the CLI version.
Execute mcloud deployments commands to list deployments, retrieve deployment details, and fetch build logs. Use when listing deployments, checking deployment status, or reading build output for debugging build failures.
Execute mcloud environments commands to list, get, create, delete, redeploy, or trigger builds for Cloud environments. Use when managing environment lifecycle, redeploying after variable changes, or starting new builds from source.
Execute mcloud logs to fetch and stream runtime logs for Cloud environments. Use when reading backend or storefront logs, filtering by time range, searching for errors, or scoping logs to a specific deployment.
Execute mcloud organizations commands to list or get Cloud organizations. Use when discovering organizations, resolving organization IDs by name, or retrieving organization details including members and subscription.
Execute mcloud variables commands to list and get environment variables for a Cloud environment. Use when inspecting, reading, or exporting environment variables. Never pass --reveal unless the user explicitly requests secret values.