18 skills · 52 min
Medusa Cloud
Skill 9 of 18
Execute mcloud projects commands to list, get, or delete Cloud projects.
1 minute · 192 words · 8 sections
Install
npx skills add medusajs/medusa-agent-skills --skill mcloud-projectsnpx skills add medusajs/medusa-agent-skills/plugin marketplace add medusajs/medusa-agent-skillsThe first command installs just this skill, by the name in its SKILL.md; the second installs the whole repository.
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.
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 JSONRetrieve a single project by its ID or handle.
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 JSONDelete a project by its ID or handle. Irreversible.
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| 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) |
# 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
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 verbatim description from this skill’s front matter — the string an agent matches on to decide whether to load it.
Bash(mcloud projects*)Bash(mcloud use*)Bash(jq*)plugins/medusa-cloud/skills/mcloud-projects/SKILL.mdmain, last pushed 22 September 2026.SKILL.md, not by matching a directory convention. 4 distinct layouts observed: plugins/ecommerce-storefront/skills/*/SKILL.md, plugins/learn-medusa/skills/*/SKILL.md, plugins/medusa-cloud/skills/*/SKILL.md, plugins/medusa-dev/skills/*/SKILL.md.h1 and no skipped levels:.claude-plugin/marketplace.json by Medusa, declaring 4 plugins. It is read for editorial metadata only — never as the skill index, which is always the repository tree./medusajs/medusa-agent-skills.md, and each skill at its own .md URL.