# mcloud-variables

An agent skill that drives mcloud variables for Medusa Cloud environments: list keys, read one, write, delete, export to .env.

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

## What it does

The skill hands your agent a narrow set of `mcloud variables` calls. It can pull a full key list for an environment, fetch a single entry by key or `var_...` ID, create or update values, remove them, and dump everything into dotenv format. Four subcommands cover the work: `list`, `get`, `set`, `delete`. Tool access is scoped to `Bash(mcloud variables*)`, `Bash(mcloud environments*)` and `Bash(jq*)`.

Writes alone change nothing in a running app. A runtime value needs `mcloud environments redeploy <env>` afterwards; a build value needs `mcloud environments trigger-build <env>`, because a redeploy reuses the existing image and skips build-time changes. Miss that and the agent reports success while the live app keeps the old value.

Secrets stay masked unless you ask to see them, and the skill treats `--reveal` as off-limits otherwise. System variables cannot be deleted. In non-interactive runs `delete` also needs `--yes`. Key-based lookup and creation require `--project` and `--environment`, while an ID lookup skips both. You need mcloud CLI v0.1.10 or later for `set` and `delete`.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- audit every variable in an environment before a release
- push a local `.env` file into a Cloud environment
- check whether a key is stored as a secret
- mark a key build-only and rebuild the image
- remove an obsolete flag without touching system entries

## Example prompts
- List the runtime variables for production as JSON, system ones included
- Create `REDIS_URL` set to `redis://cache:6379` and redeploy so it takes effect
- Export everything to `.env` and show the secrets, I'm asking for them explicitly

## Similar
- [wizard](https://affpapa.org/en/nevibecode/skills/wizard.md) — skill · 553369 installs
- [hyperframes-cli](https://affpapa.org/en/nevibecode/skills/heygen-com-hyperframes-cli.md) — skill · 1300000 installs
- [setup-pre-commit](https://affpapa.org/en/nevibecode/skills/setup-pre-commit.md) — skill · 489289 installs
- [using-git-worktrees](https://affpapa.org/en/nevibecode/skills/using-git-worktrees.md) — skill · 217153 installs
- [finishing-a-development-branch](https://affpapa.org/en/nevibecode/skills/finishing-a-development-branch.md) — skill · 214439 installs
- [orca-cli](https://affpapa.org/en/nevibecode/skills/orca-cli.md) — skill · 353600 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