env:list

Use env:list to retrieve a list of environment variables for your project from the control plane.

About env:list

This section describes what the command returns and how the variables are grouped.

The command outputs the results as a JavaScript Object Notation (JSON) array directly to your terminal. It helps you inspect your environment-specific configuration values across different branches.

Using env:list

This section provides a repeatable workflow for running the command with flags or environment variables.

Concept and Goal

To audit your current variables or confirm your keys are correctly populated, use this procedure to list all environment variables scoped to your project.

What you need

• You installed the CLI package.
• You set MONOLAYER_BASE_URL or plan to pass --base-url.
• You set MONOLAYER_AUTH_TOKEN (must be a deployment token starting with deploy_token_) or plan to pass --auth-token.

Numbered Steps

1. Run the command with explicit flags to list the variables for your project.

npx mnlyr env:list \
  --base-url https://control-plane-domain \
  --auth-token deploy_token_xxx \
  --project-id proj-1

2. Run the command with environment variables when you prefer session defaults.

MONOLAYER_BASE_URL="https://control-plane-domain" \
MONOLAYER_AUTH_TOKEN="deploy_token_xxx" \
npx mnlyr env:list --project-id proj-1

Expected Result

The command returns a JSON payload containing an items array with your keys, values, environments, and their modification timestamps.

env:list Reference

This section lists command syntax, options, and sample output.

Command syntax

npx mnlyr env:list [options]

Options

Output

{
  "items": [
    {
      "name": "API_KEY",
      "value": "secret-value",
      "environment": "production",
      "updatedAt": "2026-06-19T11:23:17.000Z"
    }
  ]
}

Troubleshooting

This section lists common command errors.

• Missing base URL: Missing base URL. Pass --base-url explicitly or set MONOLAYER_BASE_URL.
• Missing authentication token: Missing auth token. Pass --auth-token explicitly or set MONOLAYER_AUTH_TOKEN.
• Invalid token format: auth-token must start with "deploy_token_"