# mcloud-deployments

Enables agents to query Medusa Cloud deployments and inspect build logs via CLI. Useful for tracking release progress and debugging failed builds directly in the terminal.

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

## What it does

This skill guides the agent through `mcloud deployments` CLI operations. It provides clear execution patterns to list project deployments, filter by commit or environment handle, and fetch deployment details using build or deployment identifiers. The agent relies on command execution with `jq` for output processing.

Every query must include `--json` because plain text output is not guaranteed to remain stable. If organization or project contexts are missing, the agent verifies them first with `mcloud whoami --json`.

When a build fails, the skill pulls logs specifically for the backend or storefront stream. Note the failure status: if a deployment ends in `deployment-failed` instead of `build-failed`, build logs will be clean, so you must inspect runtime logs using `mcloud logs`.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- list recent deployments for a project
- inspect build logs for backend or storefront
- filter deployment runs by commit SHA or environment
- diagnose why a deployment status failed

## Example prompts
- Show me recent deployments for this Medusa Cloud project
- Fetch the build logs for the latest failed deployment
- Check if the latest commit deployed cleanly to production

## Similar
- [troubleshooting-astro-deployments](https://affpapa.org/en/nevibecode/skills/troubleshooting-astro-deployments.md) — skill · 622 installs
- [managing-astro-deployments](https://affpapa.org/en/nevibecode/skills/managing-astro-deployments.md) — skill · 567 installs
- [vercel-deployments-builds](https://affpapa.org/en/nevibecode/skills/vercel-deployments-builds.md) — skill · 368 installs
- [vercel-deployments](https://affpapa.org/en/nevibecode/skills/vercel-deployments.md) — skill · 316 installs
- [deployments-cicd](https://affpapa.org/en/nevibecode/skills/deployments-cicd.md) — skill · 7 installs
- [status](https://affpapa.org/en/nevibecode/commands/status.md) — command · 348 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