Settings

Settings live in ~/.grok/config.toml (on Windows, %USERPROFILE%\.grok\config.toml). Specify only the values you want to override; everything else falls back to built-in defaults. Settings can also be changed from the TUI Settings modal.

Text

[ui]
scroll_speed = 50          # mouse-wheel / trackpad scroll speed, 1-100 (higher = faster)
vim_mode = false           # vim-style scrollback navigation keys

[session]
auto_compact_threshold_percent = 85  # auto-compact at this % of context window

File toolset (hashline edits)

By default Grok edits files with the standard toolset (read_file, search_replace, grep). You can switch to the anchor-based hashline toolset (hashline_read, hashline_edit, hashline_grep), which reads and edits files using stable line anchors instead of exact string matches:

Text

[toolset]
file_toolset = "hashline"   # "standard" (default) or "hashline"

[toolset.hashline]
scheme = "chunk"            # "chunk" (default) or "content_only"
hash_len = 3                # anchor hash length, 1-4 (default 3)
chunk_size = 8              # chunk size for the chunk scheme (default 8)

The two toolsets are mutually exclusive. The [toolset.hashline] parameters only apply when file_toolset = "hashline".


Last updated: June 21, 2026