Skip to content

Environments

Environment files use dotenv format and live in the .environments/ subdirectory of your collection.

my-collection/.environments/production.env
API_URL=https://api.example.com
API_KEY=sk-prod-abc123
USER_EMAIL=admin@example.com
my-collection/.environments/staging.env
API_URL=https://staging-api.example.com
API_KEY=sk-staging-xyz789
USER_EMAIL=admin@example.com

Reference environment variables in your requests with {{var}} syntax:

url: "{{API_URL}}/users"
headers:
- key: Authorization
value: "Bearer {{API_KEY}}"
enabled: true

Prefix a line with # to disable a variable:

Terminal window
# API_KEY=sk-old-key

Disabled variables are not available for substitution.

Use _color in your .env file to set the sidebar badge color:

Terminal window
_color=green
API_URL=https://api.example.com

Set the default environment in settings.yml:

environment: production

Press Ctrl+P to cycle through available environments in the TUI.

Press e to open the full environment editor. The TUI switches to a split view:

  • Sidebar (left) — lists all .env files, shows color dots and an unsaved indicator (yellow bullet)
  • Header (top) — edit the environment name and pick a color badge
  • Main — key/value grid with enable/disable checkboxes
Key Action
Ctrl+S Save environment
Ctrl+N Create new environment
Ctrl+K Clone selected environment
Ctrl+W Delete environment (with confirmation)
/ Navigate rows
Return Edit field
Tab Switch between key and value fields
Space Select environment in sidebar
  • Dirty tracking — unsaved changes show a yellow bullet
  • Color badges — pick from 17 theme colors (green, blue, red, etc.)
  • Disable variables — checkbox toggles a # prefix in the .env file
  • Clone — appends “ - Copy“ to the name, duplicates all vars