Documentation 2026-06-11 08:59 UTC to 2026-06-14 22:02 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 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 

44## Core TUI commands57## Core TUI commands

45 58 

46The command palette groups session, context, model, and tool actions.59The command palette groups session, context, model, and tool actions.

46 46 

47## Custom models47## Custom models

48 48 

49Grok supports any custom model:49Grok supports any custom model. Add it to your user-level config file, `~/.grok/config.toml` (on Windows, `%USERPROFILE%\.grok\config.toml`):

50 50 

51```text51```text

52[model.my-model]52[model.my-model]

59default = "my-model"59default = "my-model"

60```60```

61 61 

62After updating config, use `grok inspect` to see what Grok discovered in the current directory, including config sources, instructions, skills, plugins, hooks, and MCP servers, then pick the model in headless mode or in the TUI:62After updating `~/.grok/config.toml`, use `grok inspect` to see what Grok discovered in the current directory, including config sources, instructions, skills, plugins, hooks, and MCP servers, then pick the model in headless mode or in the TUI:

63 63 

64```bash customLanguage="bash"64```bash customLanguage="bash"

65grok inspect65grok inspect