Environment Variables
The engine reads a small set of environment variables. They are useful for scripted runs and CI, where you would rather not write a config file. Most have a matching CLI flag.
Provider and model
Section titled “Provider and model”| Variable | Maps to | Description |
|---|---|---|
PROVIDER | --provider | Provider to use, for example anthropic. |
API_KEY | --api-key | API key for the active provider. |
BASE_URL | --base-url | Base URL for an OpenAI-compatible provider. |
MODEL | --model | Model id. |
ANTHROPIC_API_KEY | Anthropic key, read when the provider is Anthropic and no other key is set. | |
OPENAI_API_KEY | OpenAI key, read when the provider is OpenAI and no other key is set. |
For AWS Bedrock and Google Vertex AI, the engine also reads the standard cloud credentials (for example AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY). See Providers and Auth.
Local models
Section titled “Local models”| Variable | Description |
|---|---|
OLLAMA_BASE_URL | Override the Ollama endpoint used by the ollama: model route. |
Paths and runtime
Section titled “Paths and runtime”| Variable | Description |
|---|---|
WAYLAND_HOME | Base directory for engine data. When set, it is used directly. When unset, configuration, sessions, and memory live under the platform config directory in a wayland-core subfolder (on macOS, ~/Library/Application Support/wayland-core; on Linux, $XDG_DATA_HOME/wayland-core or ~/.config/wayland-core; on Windows, %APPDATA%\wayland-core), while logs, cron jobs, evolved prompts, and user agents default to ~/.wayland. |
XDG_DATA_HOME | On Linux, used as the config base ($XDG_DATA_HOME/wayland-core) when WAYLAND_HOME is unset. |
RUST_LOG | Log filter, for example info or debug. Defaults to info. |
TERM | Read to decide whether a terminal can drive the full-screen TUI. A value of dumb falls back to the line REPL. |
Key resolution order
Section titled “Key resolution order”When the engine looks for an API key, it checks, in order:
- The
--api-keyflag. - The config file
providers.<name>.api_key. - The
API_KEYenvironment variable. ANTHROPIC_API_KEYorOPENAI_API_KEY, depending on the provider.- Saved OAuth credentials from
--login.
AWS Bedrock and Google Vertex AI use their own cloud credentials and do not need a traditional API key.