mcloud-variables
Execute mcloud variables commands to list, get, set, and delete environment variables for a Cloud environment. Use when inspecting, reading, creating, updating, deleting, or exporting environment variables. Never pass --reveal unless the user explicitly requests secret values.
By medusajs · 1,000 installs
npx skills add medusajs/medusa-agent-skills --skill mcloud-variables
Source repository · Upstream listing
Cloud CLI: Variables Commands
Execute mcloud variables commands to inspect and manage environment variables for Cloud environments.
Constraints
Never pass reveal unless the user explicitly asks. Secret values appear in terminal scrollback, log aggregators, and process listings.
Variable changes need a deploy to apply. set / delete don't rebuild or redeploy. Run mcloud environments redeploy <env for a runtime variable, or mcloud environments trigger build <env for a build variable (a redeploy reuses the existing image and won't pick up build variable changes).
System variables can't be deleted , and delete requires yes in non interactive mode.
Looking up or creating a variable by key requires project and environment (or the equivalent in active context). Referencing by ID ( var ... ) works without project/environment context.
set and delete require mcloud CLI v0.1.10+.
Commands
variables list
List all environment variables for a Cloud environment.
Options:
o/ organization <id — Organization ID (falls back to active context)
p/ project <id or handle — Project ID or handle (falls back to active context)
e/ environment <handle — Environment handle (falls back to active context)
t/ type <backend storefront — Which variable set to list (default: backend )
scope <build runtime — Filter by scope; repeatable (default: both scopes)
include system — Include system variables Medusa auto injects (default: false )
reveal — Print secret values in plaintext instead of masking ( use only when explicitly asked )
dotenv — Output .env formatted KEY=VALUE lines instead of a table
json — Output as JSON
variables get
Retrieve a single variable by its ID ( var ... ) or key.
Arguments:
variable — Variable ID ( var ... ) or key (required)
Options:
o/ organization <id , p/ project <id or handle , e/ environment <handle
t/ type <backend storefront — Which variable set to read (default: backend )
reveal — Print secret value in plaintext ( use only when explicitly asked )
json — Output as JSON
variables set
Create or update one or more variables. The CLI updates when you reference an existing key or a var ... ID, and creates otherwise.
Arguments:
variable — Variable ID ( var ... ) or key to set (omit when using var / env file )
value — Value to set (required when a variable argument is passed)
Options:
o/ organization <id , p/ project <id or handle , e/ environment <handle
t/ type <backend storefront — Which variable set to write (default: backend )
v/ var <KEY=VALUE ID=VALUE — A variable to set; repeatable
env file <path — Set all variables from a .env file
secret , no secret — Mark as secret (default: false for new variables)
build , no build — Available at build time (default: false for new variables)
runtime , no runtime — Available at runtime (default: true for new variables)
json — Output as JSON
Redeploy (runtime) or trigger build (build) afterward — see Constraints.
variables delete
Delete a variable by its ID ( var ... ) or key. Irreversible; system variables can't be deleted.
Arguments:
variable — Variable ID ( var ... ) or key to delete (required)
Options:
o/ organization <id , p/ project <id or handle , e/ environment <handle
t/ type <backend storefront — Which variable set to delete from (default: backend )
y/ yes — Skip confirmation prompt (required in non interactive mode)
json — Output as JSON
Variable Fields (JSON)
Field Description
id Variable ID ( var ... )
key Variable name (e.g. ADMIN CORS )
value Variable value (masked if is secret and reveal not passed)
is secret Whether the variable is treated as a secret
is build Available at build time
is runtime Available at runtime
environment id The environment ID this variable belongs to
source user for user set variables, system for auto injected ones
Examples