Skip to content

CommandLineConfigOverrides

Defined in: core/dist/config/types.d.ts:671

optional customConfigPath?: string

Defined in: core/dist/config/types.d.ts:675

Custom config path


optional identityProfile?: string

Defined in: core/dist/config/types.d.ts:704

Separate identity profile. May include separate identity, guidelines and command protocol, making gsloth behave as an agent different from default profile behaviour. for example, devops profile to detect changes such as properties and environment variables. Custom config can still win over this one. This setting requires .gsloth/.gsloth-settings directory to exist. Important to note that the profile directory substitutes the entire config directory, in the case if some prompt files are missing - a file from the installation directory will be used.


optional model?: string

Defined in: core/dist/config/types.d.ts:728

BATCH-1 fix — run with a different model than the configured llm.model, just for this initConfig() call. Used by gth batch --models a,b,c to build one genuinely fresh GthConfig (with its own freshly-constructed .llm) per distinct model in the matrix, instead of structurally cloning an already-instantiated LangChain model object (unsafe for any provider class that keeps state behind private #fields). Applied in tryJsonConfig by overriding llmConfig.model before the provider’s processJsonConfig() builds the instance, so it flows through the same supported construction path every other model comes from.

Only takes effect for JSON (.gsloth.config.json) configs — a configure()-style JS/MJS/TS module config already returns a fully-built GthConfig (LLM included) with no generic seam to re-target its model.


optional tui?: boolean

Defined in: core/dist/config/types.d.ts:713

Interactive TUI activation override for chat/code sessions.

  • true (--tui): force the Ink TUI on where the terminal supports it (also overrides the CI auto-off heuristic).
  • false (--no-tui): force the plain readline session.
  • undefined (default): auto-detect from the terminal. The decision itself lives in gaunt-sloth’s shouldUseTui; this only carries the flag.

optional verbose?: boolean

Defined in: core/dist/config/types.d.ts:681

Set LangChain/LangGraph to verbose mode, causing LangChain/LangGraph to log many details to the console. debugLog from config.ts may be a less intrusive option.


optional writeOutputToFile?: string | boolean

Defined in: core/dist/config/types.d.ts:693

Should the output be written to md file. (e.g. gth_2025-07-26_22-59-06_REVIEW.md). Defaults to false (no file is written); set to true for the standard gth_<timestamp>_<COMMAND>.md name. Can be set to false with -wn or -w0 Can be set to a specific filename or path by passing a string:

  • Bare filenames (e.g. "review.md") are placed in .gsloth/ when it exists, otherwise project root
  • Paths with separators (e.g. "./review.md" or "reviews/last.md") are always relative to project root Please note the string does not accept absolute path, but allows to exit project with .. if necessary.