AgentFlow
Reference

Environment variables

Environment variables read by AgentFlow at runtime.

Environment variables

AgentFlow reads a small, explicit set of environment variables. They exist so CI, shells, and wrappers can flip global behavior without rewriting configs.

VariableEffect
AGENTFLOW_DRY_RUNWhen 1, same as global --dry-run (also set by exec layer)
AGENTFLOW_YESWhen 1, auto-confirms interactive prompts (requireConfirm)
NOTION_TOKENDefault Notion API token when sources.notion.token_env is NOTION_TOKEN
NOTION_TEST_PAGE_IDIntegration tests only (source/notion/integration_test.go)
UPDATE_GOLDENWhen 1, refresh golden test files in cost package

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_SECRET
export MY_NOTION_SECRET="..."

CI usage

AGENTFLOW_DRY_RUN=1 is the usual way to exercise orchestration in pipelines without spawning configured binaries. Reserve AGENTFLOW_YES=1 for jobs that must auto-accept prompts after you are certain budget confirmations should not block the job.

env:
  AGENTFLOW_DRY_RUN: "1"

Avoid AGENTFLOW_YES=1 unless the pipeline must bypass budget confirmations intentionally.