Environment variables

Paths

Var	Purpose
HOME	Used for ~ expansion.
GUILDHALL_CONFIG_DIR	Override global config root (default ~/.guildhall).
GUILDHALL_DATA_DIR	Override data/history/cache root (sessions, transcripts, checkpoints, local evidence).
GUILDHALL_LOGS_DIR	Override log directory.

Provider selection

Var	Purpose
GUILDHALL_PROVIDER	Force provider: claude-oauth, codex-oauth, anthropic-api, openai-api, llama-cpp. lm-studio is accepted as an alias for llama-cpp.

Credentials

Var	Purpose
ANTHROPIC_API_KEY	Claude API key (alternative to OAuth).
OPENAI_API_KEY	OpenAI API key.
CLAUDE_CREDENTIALS_PATH	Path to Claude OAuth credentials file.
CODEX_CREDENTIALS_PATH	Path to Codex credentials file.

Local model servers

Var	Purpose
LM_STUDIO_BASE_URL	Compatibility env var for an OpenAI-compatible local server URL, often LM Studio.
LLAMA_CPP_URL	OpenAI-compatible local server URL, commonly llama.cpp or LM Studio.
LM_STUDIO_MODEL	Default model name for local-server tests.

CLI targeting

Var	Purpose
FORGE_WORKSPACE	Default workspace id when CLI command doesn't specify one. (Name preserved for historical reasons; applies to guildhall as well.)