Environments

Use the environment CLI to inspect and update the active environment after you have selected it with set-env.

The active environment is stored in .ascendkit/env.json. The CLI walks up from the current working directory until it finds the nearest .ascendkit folder.

Select an environment

ascendkit env list --project prj_abc123
ascendkit set-env <public-key>

set-env updates the local CLI context. Variable commands below apply to the currently selected environment.

If local .env, .env.local, or .env.example files are present in the project tree, environment selection also syncs the AscendKit-managed keys into those files.

Show the active environment

ascendkit environment show

Environment Variables

Environment runtime settings are stored as key-value pairs on the environment and appear on the environment settings page in the portal.

List values

ascendkit vars list

Set a value

ascendkit vars set API_BASE_URL https://api.example.com
ascendkit vars set SUPPORT_EMAIL [email protected]

Remove a value

ascendkit vars remove SUPPORT_EMAIL

Update environment metadata

ascendkit environment update \
  --name "Preview" \
  --description "Customer QA environment"

Promote an environment

ascendkit environment promote --target production

Variable key rules

• Keys must start with a letter or underscore.
• Keys may contain letters, digits, underscores, and hyphens.
• Values are stored as strings.