Environments
Environments are named bundles of .env files. Switching environments swaps which files are loaded into hurl as --variables-file flags, and re-tints the titlebar so you always know which one is active.
Defining environments
In settings.toml:
[[environment]]
name = "Beta"
color = "#5E81AC"
files = [".env/.env", ".env/.beta.env"]
[[environment]]
name = "Production"
color = "#BF616A"
files = [".env/.env", ".env/.production.env"]
| Key | Required | Notes |
|---|---|---|
name | yes | Shown in the dropdown. Must be unique across the array. |
color | no | Hex string. Used for the swatch + titlebar tint. Defaults to a palette color when omitted. |
files | no | List of .env files, in layering order — later files override earlier ones. Paths are relative to the workspace root. |
Switching
- Toolbar dropdown — click the environment pill, top-right.
- ⌥1–9 — jump directly to the Nth environment (matches the order in
settings.toml). - The active environment's color tints the titlebar so the current context is always visible.
Auto-discovery
When Gurl detects a new .env* file in your workspace that doesn't appear in any environment, it seeds one for you using a friendly name derived from the filename.