Skip to content

Environment variables

For options with a corresponding CLI flag: flag > environment > config.

gdc — model and data

Variable Flag Effect
GDC_BASE_URL --base-url Model endpoint
GDC_MODEL --model Model name
GDC_REASONING --reasoning Reasoning effort
GDC_API_KEY --api-key Endpoint credential; value hidden in help
GDC_CONFIG --config Explicit TOML file
GDC_DB_PATH --db-path Session database
GDC_SESSION_ID --session-id Session id
GDC_SERVE_BIND serve --bind Server listen address
GDC_SWARM_TLS_CA serve --swarm-tls-ca, swarm --tls-ca PEM trust bundle for swarm clients

gdc-tui — the terminal app

Variable Flag Effect
GDC_TUI_BIND --bind Server address
GDC_TUI_DB_PATH --db-path Local database
GDC_TUI_CONFIG --config Local configuration
GDC_TUI_PROFILE --profile Initial local profile
GDC_TUI_CWD --cwd Local project directory
GDC_TUI_LOG_DIR --log-dir Log directory

Local settings are ignored in remote mode; logging still applies.

Behavior toggles

Variable Effect
GDC_SHELL Override the command shell
GDC_DISABLE_MOUSE Disable TUI mouse capture when set
RUST_LOG Diagnostic filter, such as info or debug

Standard system variables

Variable Use
HOME / Windows USERPROFILE User data directory
XDG_CONFIG_HOME XDG configuration directory
PATH Resolve tool and server executables

Example: configure via environment

export GDC_BASE_URL="http://localhost:11434/v1"
export GDC_MODEL="qwen3.5:latest"
gdc print "summarise this project"