Skip to content
Gaunt Sloth Documentation

CommandLineConfigOverrides

Defined in: _worktrees/docs-release/gaunt-sloth/packages/core/src/config/types.ts:773

Properties

Section titled “Properties”

customConfigPath?

Section titled “customConfigPath?”

optional customConfigPath?: string

Defined in: _worktrees/docs-release/gaunt-sloth/packages/core/src/config/types.ts:777

Custom config path

global?

Section titled “global?”

optional global?: boolean

Defined in: _worktrees/docs-release/gaunt-sloth/packages/core/src/config/types.ts:840

Run with global configuration only, bypassing project-level configuration. When true, up-tree project config discovery is bypassed, loading configuration solely from ~/.gsloth/ (merged over default fallbacks). If paired with an identity profile, resolves under ~/.gsloth/.gsloth-settings//.

identityProfile?

Section titled “identityProfile?”

optional identityProfile?: string

Defined in: _worktrees/docs-release/gaunt-sloth/packages/core/src/config/types.ts:806

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.

model?

Section titled “model?”

optional model?: string

Defined in: _worktrees/docs-release/gaunt-sloth/packages/core/src/config/types.ts:833

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.

tui?

Section titled “tui?”

optional tui?: boolean

Defined in: _worktrees/docs-release/gaunt-sloth/packages/core/src/config/types.ts:818

Interactive TUI activation override for chat/code sessions, as passed on the command line.

  • true (--tui): force the Ink TUI on where the terminal supports it (it outranks the GTH_NO_TUI escape hatch, the GthConfig.tui config key and the CI auto-off heuristic).
  • false (--no-tui): force the plain readline session.
  • undefined (default): defer to the next rung down — GTH_NO_TUI, then the GthConfig.tui config key, then terminal auto-detect. This carries only the FLAG; the persistent preference is GthConfig.tui. The decision that ranks them lives in gaunt-sloth’s shouldUseTui.

verbose?

Section titled “verbose?”

optional verbose?: boolean

Defined in: _worktrees/docs-release/gaunt-sloth/packages/core/src/config/types.ts:783

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.

writeOutputToFile?

Section titled “writeOutputToFile?”

optional writeOutputToFile?: string | boolean

Defined in: _worktrees/docs-release/gaunt-sloth/packages/core/src/config/types.ts:795

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.