# mcloud-environments

Manage mcloud environments from your agent: inspect, create, or remove them, then rerun a deployment or start a fresh build. Useful when changing environment settings or shipping committed code.

- 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-environments/SKILL.md
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/skills/mcloud-environments

## What it does

The skill runs `mcloud environments` commands to list project environments, retrieve one environment’s details, create a long-lived environment linked to a Git branch, or delete an environment. Non-interactive deletion uses `--yes`. Production environments cannot be deleted, so check the environment type before attempting that operation.

Choose `redeploy` when the change is in the environment, such as updated variables or infrastructure configuration. It reruns the existing build and requires an active deployment. For committed changes on the tracked branch, `trigger-build` starts a new build and creates a deployment. The commands also support JSON output.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add medusajs/medusa-agent-skills --skill mcloud-environments -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-environments/SKILL.md

## When to use it
- list project environments
- inspect an environment by ID or handle
- create an environment linked to a Git branch
- rerun a deployment after changing variables
- start a fresh build from committed code

## Example prompts
- List this project’s environments as JSON.
- Create a `Staging` environment that tracks `develop`.
- Redeploy `production` after its variables change; start a new build if the fix is in the tracked code.

## Similar
- [caveman-manage](https://affpapa.org/en/nevibecode/skills/caveman-manage.md) — skill · 104200 installs
- [workers-best-practices](https://affpapa.org/en/nevibecode/skills/cloudflare-workers-best-practices.md) — skill · 126100 installs
- [cloudflare-email-service](https://affpapa.org/en/nevibecode/skills/cloudflare-email-service.md) — skill · 102300 installs
- [firebase-basics](https://affpapa.org/en/nevibecode/skills/firebase-basics.md) — skill · 14100 installs
- [cloudflare-one](https://affpapa.org/en/nevibecode/skills/cloudflare-one.md) — skill · 93100 installs
- [cloudflare-one-migrations](https://affpapa.org/en/nevibecode/skills/cloudflare-one-migrations.md) — skill · 89500 installs

From the same set: [medusajs/medusa-agent-skills](https://affpapa.org/en/nevibecode/by/medusajs/medusa-agent-skills.md) — 14 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