# mcloud-projects

Runs Medusa Cloud CLI commands to inspect and delete projects. Useful when managing cloud deployments and switching active project handles.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1300 installs · ★ 235
- Author: medusajs
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/medusajs/medusa-agent-skills/tree/HEAD/plugins/medusa-cloud/skills/mcloud-projects/SKILL.md
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/skills/mcloud-projects

## What it does

This skill teaches your assistant to control Medusa Cloud projects directly through the terminal. It relies on `mcloud projects`, `mcloud use`, and `jq` to run queries and extract structured JSON data.

The agent can run `mcloud projects list` across organizations or fetch single project records with `mcloud projects get`. Returned payloads include project identifiers, handles, deployment regions, and environment arrays. It can also pipe data through `jq` to update the active CLI target with `mcloud use`.

Deleting a project with `mcloud projects delete` is permanent. Because removal destroys all linked environments and deployments, the agent must pass `--yes` in non-interactive pipelines. Double-check your project handle before running it.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add medusajs/medusa-agent-skills --skill mcloud-projects -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/mcloud-projects/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/mcloud-projects/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add medusajs/medusa-agent-skills --skill mcloud-projects -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/mcloud-projects/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add medusajs/medusa-agent-skills --skill mcloud-projects -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/mcloud-projects/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install medusajs/medusa-agent-skills mcloud-projects
```

2. **Manually: put the files in place**
- File: `.github/skills/mcloud-projects/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add medusajs/medusa-agent-skills --skill mcloud-projects -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/medusajs/medusa-agent-skills --path plugins/medusa-cloud/skills/mcloud-projects
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/mcloud-projects/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add medusajs/medusa-agent-skills --skill mcloud-projects -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/medusajs/medusa-agent-skills/tree/HEAD/plugins/medusa-cloud/skills/mcloud-projects/SKILL.md

## When to use it
- find a project handle by store name
- list cloud projects and inspect linked environments
- switch active context using `mcloud use`
- delete a cloud project without interactive prompts

## Example prompts
- Find the handle for project My Store in org_123 and set it as active using mcloud use
- Show all projects and linked environments in organization org_123
- Delete project old-project in org_123 using the non-interactive flag

## Similar
- [prisma-compute](https://affpapa.org/en/nevibecode/skills/prisma-compute.md) — skill · 371800 installs
- [insforge-cli](https://affpapa.org/en/nevibecode/skills/insforge-cli.md) — skill · 60500 installs
- [shell](https://affpapa.org/en/nevibecode/rules/shell.md) — rule · ★ 40418
- [skill-stocktake](https://affpapa.org/en/nevibecode/skills/skill-stocktake.md) — skill · 4500 installs
- [webflow-cli:cloud](https://affpapa.org/en/nevibecode/skills/webflow-clicloud.md) — skill · 1000 installs
- [huawei-cloud-devbridge-tunnel](https://affpapa.org/en/nevibecode/skills/huawei-cloud-devbridge-tunnel.md) — skill · 799 installs

From the same set: [medusajs/medusa-agent-skills](https://affpapa.org/en/nevibecode/by/medusajs/medusa-agent-skills.md) — 12 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md