Skip to main content

Environment Variables

drwn reads the following environment variables. All are optional; documented defaults apply when unset.

Store and paths​

AGENTS_HOME_DIR​

Overrides the directory used as the home root for the local store. When unset, drwn uses HOME, USERPROFILE, or os.homedir() in that order.

The store lives at $AGENTS_HOME_DIR/.agents/drwn/ (or ~/.agents/drwn/ by default).

export AGENTS_HOME_DIR=/mnt/shared-home
drwn status

AGENTS_REPO_ROOT​

Points drwn at a local checkout of darwinian-worker as the harness source, instead of the bundled package defaults. Used when developing the CLI or maintaining a fork.

export AGENTS_REPO_ROOT=/path/to/darwinian-worker
drwn status

DRWN_STORE_READONLY​

Set to "1" or "true" to refuse any store mutation. Inspection and dry-run commands (drwn doctor, drwn status, drwn write --dry-run) still work; write operations that would mutate the store exit with an error.

Intended for CI environments where the store should be pre-seeded and not modified:

export DRWN_STORE_READONLY=1
drwn doctor --json

DRWN_STORE_SEED_PATH​

Path to a pre-seeded credential archive. When set, drwn initializes the credential store from this file before any store operations. Useful for supply-chain-safe CI setups where credentials are injected as a secret file.

Network and concurrency​

DRWN_STUDIO_API_URL​

Overrides the Deploy API origin used by drwn worker commands. The default is https://api.darwinian.dev.

Use this only for an explicitly provisioned staging, development, or custom Deploy API:

DRWN_STUDIO_API_URL=https://api-staging-main.darwinian.dev \
DRWN_DAH_RESOURCE=https://api-staging-main.darwinian.dev \
drwn worker status <slug>

The API override and token-resource override are separate by design. The retired production endpoint https://studio.darwiniantools.com is not a supported compatibility route.

DRWN_STUDIO_WEB_URL​

Overrides the browser origin printed for asynchronous worker runs. The default is https://foundry.darwinian.dev. API requests never use this value.

export DRWN_STUDIO_WEB_URL=https://foundry-staging-main.darwinian.dev
drwn worker chat <slug> --message "hello"

DRWN_DAH_HUB_URL​

Overrides the Auth Hub origin used by drwn login, token refresh, and logout. During the I80 overlap window the default remains https://auth.darwiniantools.com; staging tests must name their intended hub explicitly.

DRWN_DAH_RESOURCE​

Overrides the OAuth resource/audience requested and validated by the CLI. The default is https://api.darwinian.dev. Set it only when an explicitly provisioned non-production environment uses a different resource. If stored credentials target a different resource, sign in again with drwn login under the intended setting.

DRWN_TOKEN​

Provides a services-audience JWT for headless execution. The CLI validates it against DRWN_DAH_RESOURCE (or the new default) before sending it.

DRWN_POLL_MS​

Overrides the polling interval for worker deployment and run-status operations.

DRWN_CHAT_TIMEOUT_MS​

Overrides how long drwn worker chat waits for a terminal run state before returning the run URL and status command.

DRWN_FETCH_CONCURRENCY​

Maximum number of concurrent card fetch operations. Defaults to 4. Values that are not positive integers are ignored and the default applies.

export DRWN_FETCH_CONCURRENCY=8
drwn install

DRWN_GIT_TIMEOUT_MS​

Timeout in milliseconds for individual Git operations (clone, fetch, push). Defaults to 30000 (30 seconds). Increase for slow networks or large repositories.

export DRWN_GIT_TIMEOUT_MS=120000
drwn install

Trust and security​

DRWN_TRUSTED_SOURCES_STRICT​

Set to "1" or "true" to activate strict trusted-sources enforcement, regardless of the trustedSources.strict value in project or machine config. Any card ref that does not satisfy the allowlist fields will be rejected.

export DRWN_TRUSTED_SOURCES_STRICT=1
drwn install

See Trusted Sources for the full policy model.

See also​