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.