Skip to content

Environment variables

Variable Meaning
VAULTFOLD_HOME Root for every local directory: config, data, cache and runtime subdirectories of this path (must be absolute). Tests always set it.
VAULTFOLD_VAULT Vault to use when --vault is not given; above vault.toml and default_vault.
VAULTFOLD_IDENTITY_NAME Profile identity to unlock when --identity is not given.
VAULTFOLD_PASSPHRASE_FD Number of an inherited file descriptor to read passphrases from, one line per prompt, for automation. A passphrase is never read from an argument or an environment value.
VAULTFOLD_AGENT 1 forces agent-session detection on (the nudge, forced masking in run and inject).
VAULTFOLD_IDENTITY Reserved for machine identities, which a later change adds. This build refuses to run a command that selects an identity while it is set.
VAULTFOLD_AGENT_SOCK Agent daemon endpoint, overriding discovery: an absolute socket path on Linux and macOS (default <runtime>/agent.sock), a \\.\pipe\<name> on Windows. An endpoint that does not answer is an error (exit 3); no daemon is started for it.
VAULTFOLD_NO_AGENT 1 stops commands from starting the agent daemon automatically. A daemon that is already running is still used; vaultfold agent stop stops it.
VAULTFOLD_DEV_PASSPHRASE Dev-only: read only by the hidden dev subcommands so scripts/smoke.sh can drive them without a terminal. Never set it for a real vault; the real commands ignore it.
VAULTFOLD_ACCESSIBLE 1 selects the accessible prompt renderer (whole lines, no cursor movement, no animation) instead of the redrawing one; any other value leaves automatic selection on.
NO_COLOR Any non-empty value disables colour and every other escape sequence the interactive prompt renderer would otherwise write to the terminal; standard output and standard error never carry colour regardless.
TERM dumb selects the accessible prompt renderer and disables colour, the same as VAULTFOLD_ACCESSIBLE=1.
XDG_CONFIG_HOME, XDG_DATA_HOME, XDG_CACHE_HOME, XDG_RUNTIME_DIR Honoured on every OS when absolute (see "Paths").
HOME, APPDATA, LOCALAPPDATA Base of the OS default directories.
VISUAL, EDITOR Editor for vaultfold edit; without either, edit prompts field by field.

Agent harness markers (CLAUDECODE, CURSOR_AGENT, CODEX_SANDBOX, GEMINI_CLI, OPENCODE, CLINE_ACTIVE=true, GOOSE_TERMINAL=1, AGENT=goose) are read to detect an agent session.