CommandsEnvironment
skytells env ls
List environment variables at project or app scope.
Overview
skytells env ls lists all environment variables defined within the linked project, or scoped to a specific app. Environment variables are available at runtime as standard OS environment variables.
Syntax
skytells env ls [--app <id>] [--json]Flags
| Flag | Description |
|---|---|
--app <id> | Show variables scoped to a specific app only. Without this flag, lists project-wide variables. |
--json | Output as JSON. |
Examples
# List project-wide environment variables
skytells env ls
# List variables for a specific app
skytells env ls --app app_abc123
# JSON output
skytells env ls --json
# Extract only variable names
skytells env ls --json | jq -r '.[].key'
# Check if a specific variable exists
skytells env ls --json | jq -r '.[] | select(.key == "DATABASE_URL") | .key'Example output:
┌─────────────────────┬──────────────────────┐
│ Key │ Scope │
├─────────────────────┼──────────────────────┤
│ DATABASE_URL │ project │
│ API_KEY │ app_abc123 │
│ LOG_LEVEL │ project │
└─────────────────────┴──────────────────────┘Secret values are masked in the output. You can see the key name but not the value. To view a value, use skytells env ls --json — values are also masked in JSON output unless your token has the projects.write scope.
Scope precedence
When both project-scope and app-scope variables exist with the same key, the app-scope value takes precedence at runtime for that specific app. Use this to override project defaults on a per-app basis.
How is this guide?