Documentation 2026-10-07 23:59 UTC to 2026-10-08 23:58 UTC

65| `/compact-mode` | Toggle denser UI layout |65| `/compact-mode` | Toggle denser UI layout |

66| `/multiline` (alias `/ml`) | Toggle multiline input |66| `/multiline` (alias `/ml`) | Toggle multiline input |

67| `/vim-mode` | Toggle vim-style scrollback keybindings |67| `/vim-mode` | Toggle vim-style scrollback keybindings |

68| `/timestamps` | Toggle message timestamps |68| `/timestamps <mode>` | Set which messages show the clock time: `off`, `minimal`, or `on` |

69| `/density <level>` | Set how much of each tool call the transcript shows: `Detailed`, `Diff focus`, `Balanced`, `Grouped`, or `Compact` |

69| `/terminal-setup` | Check terminal and clipboard setup |70| `/terminal-setup` | Check terminal and clipboard setup |

70| `/config-agents` (alias `/agents`) | Manage agent definitions |71| `/config-agents` (alias `/agents`) | Manage agent definitions |

71| `/personas` | Manage personas |72| `/personas` | Manage personas |

74 74 

75[`grok-4.7`](/developers/models/grok-4.7), SpaceXAI's latest model, is available directly on the xAI API. Drop it into your own agent loop, IDE integration, or coding tool.75[`grok-4.7`](/developers/models/grok-4.7), SpaceXAI's latest model, is available directly on the xAI API. Drop it into your own agent loop, IDE integration, or coding tool.

76 76 

77```bash customLanguage="bash"77```javascript customLanguage="javascriptAISDK"

78curl https://api.x.ai/v1/responses \78import { xai } from '@ai-sdk/xai';

79 -H "Authorization: Bearer $XAI_API_KEY" \79import { generateText } from 'ai';

80 -H "Content-Type: application/json" \

81 -d '{

82 "model": "grok-4.7",

83 "input": "Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}"

84 }'

85```

86 

87```python customLanguage="pythonXAI"

88import os

89from xai_sdk import Client

90from xai_sdk.chat import user

91 

92client = Client(api_key=os.getenv("XAI_API_KEY"))

93 80 

94chat = client.chat.create(model="grok-4.7")81const { text } = await generateText({

95chat.append(user("Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}"))82 model: xai.responses('grok-4.7'),

83 prompt: 'Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}',

84});

96 85 

97print(chat.sample().content)86console.log(text);

98```87```

99 88 

100```python customLanguage="pythonOpenAISDK"89```python customLanguage="pythonOpenAISDK"

113print(response.output_text)102print(response.output_text)

114```103```

115 104 

116```javascript customLanguage="javascriptAISDK"105```bash customLanguage="bash"

117import { xai } from '@ai-sdk/xai';106curl https://api.x.ai/v1/responses \

118import { generateText } from 'ai';107 -H "Authorization: Bearer $XAI_API_KEY" \

108 -H "Content-Type: application/json" \

109 -d '{

110 "model": "grok-4.7",

111 "input": "Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}"

112 }'

113```

119 114 

120const { text } = await generateText({115```python customLanguage="pythonXAI"

121 model: xai.responses('grok-4.7'),116import os

122 prompt: 'Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}',117from xai_sdk import Client

123});118from xai_sdk.chat import user

124 119 

125console.log(text);120client = Client(api_key=os.getenv("XAI_API_KEY"))

121 

122chat = client.chat.create(model="grok-4.7")

123chat.append(user("Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}"))

124 

125print(chat.sample().content)

126```126```

127 127 

128## Features128## Features

44| --- | --- | --- |44| --- | --- | --- |

45| `GROK_THEME` | built-in | Color theme. |45| `GROK_THEME` | built-in | Color theme. |

46| `GROK_SHOW_THINKING_BLOCKS` | `1` | Show thinking/reasoning blocks in the TUI (`1`/`0`). |46| `GROK_SHOW_THINKING_BLOCKS` | `1` | Show thinking/reasoning blocks in the TUI (`1`/`0`). |

47| `GROK_GROUP_TOOL_VERBS` | `1` | Fold consecutive read/search/list tool rows (`1`/`0`). |47| `GROK_TOOL_CALL_DENSITY` | `compact-all-grouped` | Tool-call density: `detailed`, `compact-shells`, `compact-ungrouped`, `compact-grouped` or `compact-all-grouped`. |

48| `GROK_COLLAPSED_EDIT_BLOCKS` | `0` | Collapse edits to one-line `+N/-M` summaries (`1`/`0`). |

49| `GROK_PROMPT_SUGGESTIONS` | `1` | Next-prompt ghost text after each turn (`1`/`0`). |48| `GROK_PROMPT_SUGGESTIONS` | `1` | Next-prompt ghost text after each turn (`1`/`0`). |

50| `GROK_SCROLL_SPEED` | `50` | Mouse/trackpad scroll speed (`1`–`100`). |49| `GROK_SCROLL_SPEED` | `50` | Mouse/trackpad scroll speed (`1`–`100`). |

51| `GROK_SCROLL_MODE` | `auto` | Scroll input: `auto`, `wheel`, or `trackpad`. |50| `GROK_SCROLL_MODE` | `auto` | Scroll input: `auto`, `wheel`, or `trackpad`. |

161| Setting | Section | Values / default | Description |160| Setting | Section | Values / default | Description |

162| --- | --- | --- | --- |161| --- | --- | --- | --- |

163| `respect_gitignore` | `[tools]` | `true` / `false` (default `false`) | When `true`, search and read tools skip gitignored files. |162| `respect_gitignore` | `[tools]` | `true` / `false` (default `false`) | When `true`, search and read tools skip gitignored files. |

164| `disable_zdr_incompatible_tools` | `[tools]` | `true` / `false` (default `false`) | Restrict tools needing xAI-hosted output (video) under ZDR; without a configured output bucket they return setup guidance instead of generating. |163| `disable_zdr_incompatible_tools` | `[tools]` | `true` / `false` (default `false`) | Restrict tools needing SpaceXAI-hosted output (video) under ZDR; without a configured output bucket they return setup guidance instead of generating. |

165| `zdr_video_output_s3` | `[tools.zdr_video_output_s3]` | table | User-supplied S3 bucket for ZDR video output — see [Video Output Storage under ZDR](/build/settings/zdr-video-storage). |164| `zdr_video_output_s3` | `[tools.zdr_video_output_s3]` | table | User-supplied S3 bucket for ZDR video output — see [Video Output Storage under ZDR](/build/settings/zdr-video-storage). |

166| `file_toolset` | `[toolset]` | `standard` (default) | `hashline` | File edit tool scheme. |165| `file_toolset` | `[toolset]` | `standard` (default) | `hashline` | File edit tool scheme. |

167| `timeout_secs` | `[toolset.bash]` | seconds (default `120`) | Foreground bash command timeout. |166| `timeout_secs` | `[toolset.bash]` | seconds (default `120`) | Foreground bash command timeout. |

168| `output_byte_limit` | `[toolset.bash]` | bytes (default `20000`) | Max captured bash output. |167| `output_byte_limit` | `[toolset.bash]` | bytes (default `20000`) | Max captured bash output. |

169| `max_timeout_secs` | `[toolset.bash]` | seconds (default `36000`) | Cap on model-requested foreground timeouts. |168| `max_timeout_secs` | `[toolset.bash]` | seconds (default `36000`) | Cap on model-requested foreground timeouts. |

170| `auto_background_on_timeout` | `[toolset.bash]` | `true` / `false` (default `true`) | Auto-background the command on timeout. |

171| `proxy_endpoint` | `[toolset.web_fetch]` | URL | Egress proxy for `web_fetch`. |169| `proxy_endpoint` | `[toolset.web_fetch]` | URL | Egress proxy for `web_fetch`. |

172| `allowed_domains` | `[toolset.web_fetch]` | string array | Domain allowlist override for `web_fetch`. |170| `allowed_domains` | `[toolset.web_fetch]` | string array | Domain allowlist override for `web_fetch`. |

173 171 

220| --- | --- | --- | --- |218| --- | --- | --- | --- |

221| `compact_mode` | `[ui]` | `true` / `false` (default `false`) | Denser message padding. Also `/compact-mode`. |219| `compact_mode` | `[ui]` | `true` / `false` (default `false`) | Denser message padding. Also `/compact-mode`. |

222| `screen_mode` | `[ui]` | `fullscreen` (default when unset) | `minimal` | Default render mode for plain `grok`. Restart required. |220| `screen_mode` | `[ui]` | `fullscreen` (default when unset) | `minimal` | Default render mode for plain `grok`. Restart required. |

223| `show_timestamps` | `[ui]` | `true` / `false` (default `true`) | Clock time next to messages. Also `/timestamps`. |221| `timestamps` | `[ui]` | `off` | `minimal` | `on` (default `on`) | Clock time on messages. `minimal` shows it only on prompts and `Worked for` lines. Also `/timestamps`. |

222| `show_timestamps` | `[ui]` | `true` / `false` | Legacy on/off form of `timestamps` (`true` is `on`, `false` is `off`). Use `timestamps`. |

224| `show_timeline` | `[ui]` | `true` / `false` (default `false`) | Per-turn tick rail instead of the scrollbar. |223| `show_timeline` | `[ui]` | `true` / `false` (default `false`) | Per-turn tick rail instead of the scrollbar. |

225| `page_flip_on_send` | `[ui]` | `true` / `false` (default `true`) | Snap the sent prompt to the top of the viewport. |224| `page_flip_on_send` | `[ui]` | `true` / `false` (default `true`) | Snap the sent prompt to the top of the viewport. |

226| `max_thoughts_width` | `[ui]` | `40`–`500` (default `120`) | Column width for the thoughts panel. |225| `max_thoughts_width` | `[ui]` | `40`–`500` (default `120`) | Column width for the thoughts panel. |

235| `keep_text_selection` | `[ui]` | `flash` (default) | `hold` | `word_select` | In-app selection: brief flash, hold, or double-click word / triple-click paragraph select. |234| `keep_text_selection` | `[ui]` | `flash` (default) | `hold` | `word_select` | In-app selection: brief flash, hold, or double-click word / triple-click paragraph select. |

236| `cursor_blink` | `[ui]` | `true` / `false` (unset inherits terminal) | Force blinking (`true`) or steady (`false`) block cursor. |235| `cursor_blink` | `[ui]` | `true` / `false` (unset inherits terminal) | Force blinking (`true`) or steady (`false`) block cursor. |

237| `show_thinking_blocks` | `[ui]` | `true` / `false` (default `true`) | Show thinking/reasoning blocks while streaming. |236| `show_thinking_blocks` | `[ui]` | `true` / `false` (default `true`) | Show thinking/reasoning blocks while streaming. |

238| `group_tool_verbs` | `[ui]` | `true` / `false` (default `true`) | Fold consecutive read/search/list tool rows into one summary. |237| `tool_call_density` | `[ui]` | `detailed` | `compact-shells` | `compact-ungrouped` | `compact-grouped` | `compact-all-grouped` (default) | How much of each tool call shows, from full edit diffs and shell output to folded summary rows. Also `/density`. |

239| `collapsed_edit_blocks` | `[ui]` | `true` / `false` (default `false`) | Show edits as one-line `+N/-M` summaries. |

240| `render_mermaid` | `[ui]` | `auto` (default) | `on` | `off` | Mermaid diagrams: clickable open row (`auto`/`on`) or raw source (`off`). |238| `render_mermaid` | `[ui]` | `auto` (default) | `on` | `off` | Mermaid diagrams: clickable open row (`auto`/`on`) or raw source (`off`). |

241| `scroll_speed` | `[ui]` | `1`–`100` (default `50`) | Mouse/trackpad scroll speed multiplier. |239| `scroll_speed` | `[ui]` | `1`–`100` (default `50`) | Mouse/trackpad scroll speed multiplier. |

242| `scroll_mode` | `[ui]` | `auto` (default) | `wheel` | `trackpad` | Force wheel vs trackpad when auto-detection is wrong. |240| `scroll_mode` | `[ui]` | `auto` (default) | `wheel` | `trackpad` | Force wheel vs trackpad when auto-detection is wrong. |

31| `read_write` | yes | Credentials used to presign the upload URL. |31| `read_write` | yes | Credentials used to presign the upload URL. |

32| `read_only` | no | Optional credentials used to presign a playback/download URL; omit to manage retrieval yourself. |32| `read_only` | no | Optional credentials used to presign a playback/download URL; omit to manage retrieval yourself. |

33 33 

34Only the presigned URLs leave the machine — the credentials themselves are never sent to xAI. Restart Grok Build after changing the config for it to take effect.34Only the presigned URLs leave the machine — the credentials themselves are never sent to SpaceXAI. Restart Grok Build after changing the config for it to take effect.

35 35 

36Note: Video tools will be enabled if the privacy setting is off (`/privacy`).36Note: Video tools will be enabled if the privacy setting is off (`/privacy`).