npx skills add ...
npx skills add medusajs/medusa-agent-skills --skill mcloud-projects
npx skills add medusajs/medusa-agent-skills --skill mcloud-projects
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.
The same skill content is published under more than one repo. The install counts are split across them; any of these commands works.
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 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.
Options:
-o/--organization <id> — Organization ID (falls back to active context; if unset, lists across all your organizations)--json — Output as JSONRetrieve a single project by its ID or handle.
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.
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 |
organization | Owning organization (id, name, created_at) |
environments | Array of associated environments (each may include storefront_environments) |
mcloud projects delete <project-id-or-handle> \
--organization <org-id> \
--yes# 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