Environment variables
Environment variables read by Asagiri at runtime.
Environment variables
Asagiri reads a small, explicit set of environment variables. They exist so CI, shells, and wrappers can flip global behavior without rewriting configs.
| Variable | Effect |
|---|---|
ASA_DRY_RUN | When 1, same as global --dry-run (also set by exec layer) |
ASA_YES | When 1, auto-confirms interactive prompts (requireConfirm) |
NOTION_TOKEN | Default Notion API token when sources.notion.token_env is NOTION_TOKEN |
NOTION_TEST_PAGE_ID | Integration tests only (source/notion/integration_test.go) |
UPDATE_GOLDEN | When 1, refresh golden test files in cost package |
Legacy AGENTFLOW_* variables
AGENTFLOW_DRY_RUN and AGENTFLOW_YES still work but are deprecated; Asagiri prints a stderr warning and reads ASA_DRY_RUN / ASA_YES when set. Prefer the ASA_* names in new scripts and CI configs.
Custom Notion token env
If you rename the secret env var, keep token_env in sync so sync commands and Notion API calls agree on where to read credentials.
sources:
notion:
token_env: MY_NOTION_SECRETexport MY_NOTION_SECRET="..."CI usage
ASA_DRY_RUN=1 is the usual way to exercise orchestration in pipelines without spawning configured binaries. Reserve ASA_YES=1 for jobs that must auto-accept prompts after you are certain budget confirmations should not block the job.
env:
ASA_DRY_RUN: "1"Avoid ASA_YES=1 unless the pipeline must bypass budget confirmations intentionally.