Skip to content

loadGlobalRawConfig

loadGlobalRawConfig(): Promise<Partial<RawGthConfig> | undefined>

Defined in: core/dist/config/loader.d.ts:68

Loads the global gsloth config (if present) from the global ~/.gsloth folder.

Precedence support: the returned raw config is intended to act as the BASE that the project config (and CLI overrides) merge on top of, so any value here is the lowest user-controlled layer (still above DEFAULT_CONFIG).

Lookup order within the global folder, first match wins: .gsloth.config.json -> .gsloth.config.jsonc -> .gsloth.config.js -> .gsloth.config.mjs

Absence of every variant is a no-op: returns undefined so behaviour is unchanged.

NOTE: secrets (API keys) may live in this file; this function must never log its contents. Only non-sensitive diagnostics (the resolved path / parse failure) are emitted.

Promise<Partial<RawGthConfig> | undefined>

The raw global config object, or undefined when no global config exists.