Documentation 2026-06-17 02:02 UTC to 2026-06-22 00:00 UTC

41 41 

42Put this in `~/.grok/config.toml`, not project-scoped `.grok/config.toml`.42Put this in `~/.grok/config.toml`, not project-scoped `.grok/config.toml`.

43 43 

44## CLI settings44For the full set of `config.toml` options, see [Settings](/build/settings).

45 

46Settings 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.

47 

48```text

49[ui]

50scroll_speed = 50 # mouse-wheel / trackpad scroll speed, 1-100 (higher = faster)

51vim_mode = false # vim-style scrollback navigation keys

52 

53[session]

54auto_compact_threshold_percent = 85 # auto-compact at this % of context window

55```

56 45 

57## Core TUI commands46## Core TUI commands

58 47 

1# Settings

2 

3Settings 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.

4 

5```text

6[ui]

7scroll_speed = 50 # mouse-wheel / trackpad scroll speed, 1-100 (higher = faster)

8vim_mode = false # vim-style scrollback navigation keys

9 

10[session]

11auto_compact_threshold_percent = 85 # auto-compact at this % of context window

12```

13 

14## File toolset (hashline edits)

15 

16By 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:

17 

18```text

19[toolset]

20file_toolset = "hashline" # "standard" (default) or "hashline"

21 

22[toolset.hashline]

23scheme = "chunk" # "chunk" (default) or "content_only"

24hash_len = 3 # anchor hash length, 1-4 (default 3)

25chunk_size = 8 # chunk size for the chunk scheme (default 8)

26```

27 

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