SpyBara
Go Premium

Documentation 2026-08-20 23:59 UTC to 2026-08-21 19:59 UTC

50 files changed +2,091 −748. View all changes and history on the product overview
2026
Mon 31 19:59 Sat 29 07:02 Fri 28 23:02 Thu 27 21:01 Wed 26 23:58 Tue 25 19:59 Mon 24 22:00 Fri 21 19:59 Thu 20 23:59 Wed 19 22:57 Tue 18 13:01 Mon 17 23:58 Sat 15 01:01 Fri 14 22:00 Thu 13 22:59 Wed 12 19:59 Tue 11 22:59 Mon 10 22:00 Sat 8 03:02 Fri 7 18:59 Thu 6 23:58 Wed 5 19:00 Tue 4 22:00 Mon 3 23:00 Sun 2 21:00

app/automations.md +10 −12

Details

106update it before those models retire on August 31, 2026. Replace `gpt-5.4` with106update it before those models retire on August 31, 2026. Replace `gpt-5.4` with

107`gpt-5.6-terra` and `gpt-5.4-mini` with `gpt-5.6-luna`.107`gpt-5.6-terra` and `gpt-5.4-mini` with `gpt-5.6-luna`.

108 108 

109<Illustration description="ChatGPT composer ready to create a scheduled task with 5.6 Sol Extended selected.">109 

110 <CodexScheduledTasksIllustration110 

111 variant="manage"111> Illustration: ChatGPT composer ready to create a scheduled task with 5.6 Sol Extended selected.

112 ariaLabel="ChatGPT composer ready to create a scheduled task with 5.6 Sol Extended selected."112 

113 />113 

114</Illustration>

115 114 

116Scheduled tasks run unattended with your default sandbox settings. Start with the115Scheduled tasks run unattended with your default sandbox settings. Start with the

117narrowest access that lets the task succeed, and grant network or broader file116narrowest access that lets the task succeed, and grant network or broader file


125The **Scheduled** view acts as your inbox. Scheduled task runs with findings124The **Scheduled** view acts as your inbox. Scheduled task runs with findings

126appear there, and an unread indicator shows when a run needs your attention.125appear there, and an unread indicator shows when a run needs your attention.

127 126 

128<Illustration description="Scheduled tasks page with All, Active, and Paused filters and three scheduled tasks.">127 

129 <CodexScheduledTasksIllustration128 

130 variant="inbox"129> Illustration: Scheduled tasks page with All, Active, and Paused filters and three scheduled tasks.

131 ariaLabel="Scheduled tasks page with All, Active, and Paused filters and three scheduled tasks."130 

132 />131 

133</Illustration>

134 132 

135Standalone scheduled tasks start a new chat for each scheduled run and report133Standalone scheduled tasks start a new chat for each scheduled run and report

136results in **Scheduled**. Use them when each run should be independent or when one134results in **Scheduled**. Use them when each run should be independent or when one

app/browser.md +21 −19

Details

41manually, or by pressing <kbd>Cmd</kbd>+<kbd>Shift</kbd>+<kbd>B</kbd>41manually, or by pressing <kbd>Cmd</kbd>+<kbd>Shift</kbd>+<kbd>B</kbd>

42(<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>B</kbd> on Windows).42(<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>B</kbd> on Windows).

43 43 

44<CodexScreenshot44 

45 alt="ChatGPT desktop app showing a browser comment on a local web app preview"45

46 lightSrc="/images/codex/app/in-app-browser-light.webp"46 

47 darkSrc="/images/codex/app/in-app-browser-dark.webp"47> Illustration: ChatGPT desktop app showing a browser comment on a local web app preview

48 maxHeight="420px"48 

49 variant="no-wallpaper"49 

50/>50 

51 51 

52## Search from the address bar52## Search from the address bar

53 53 


152 152 

153 153 

154 154 

155<CodexScreenshot155 

156 alt="ChatGPT desktop app showing built-in browser annotation style controls"156

157 lightSrc="/images/codex/app/iab-annotations-light.webp"157 

158 darkSrc="/images/codex/app/iab-annotations-dark.webp"158> Illustration: ChatGPT desktop app showing built-in browser annotation style controls

159 maxHeight="420px"159 

160/>160 

161 

161 162 

162</section>163</section>

163 164 


212 213 

213 214 

214 215 

215<CodexScreenshot216 

216 alt="ChatGPT desktop app Browser settings showing Developer mode with full CDP access enabled"217

217 lightSrc="/images/codex/app/browser-developer-mode-light.webp"218 

218 darkSrc="/images/codex/app/browser-developer-mode-dark.webp"219> Illustration: ChatGPT desktop app Browser settings showing Developer mode with full CDP access enabled

219 maxHeight="420px"220 

220/>221 

222 

221 223 

222</section>224</section>

223 225 

Details

41are available in the ChatGPT app, and you can open recent ChatGPT chats in41are available in the ChatGPT app, and you can open recent ChatGPT chats in

42Chrome, so you can continue work in either place.42Chrome, so you can continue work in either place.

43 43 

44<Illustration description="ChatGPT open beside the current Chrome tab.">44 

45 <ChromeSidePanelIllustration45 

46 ariaLabel="ChatGPT open beside the current Chrome tab."46> Illustration: ChatGPT open beside the current Chrome tab.

47 backgroundImage="/images/codex/codex-wallpaper-1.webp"47 

48 />48 

49</Illustration>

50 49 

51## Bring tabs and selected text into a chat50## Bring tabs and selected text into a chat

52 51 


782. Approve Chrome's permission prompts.772. Approve Chrome's permission prompts.

793. Open Chrome and confirm the ChatGPT side chat loads.783. Open Chrome and confirm the ChatGPT side chat loads.

80 79 

81<Illustration description="Computer Use settings showing Google Chrome connected through the Chrome extension.">80 

82 <ComputerUseSettingsIllustration81 

83 ariaLabel="Computer Use settings showing Google Chrome connected through the Chrome extension."82> Illustration: Computer Use settings showing Google Chrome connected through the Chrome extension.

84 aspectRatio="3 / 1"83 

85 controlRows={[84 

86 {

87 id: "chrome",

88 title: "Google Chrome",

89 description: "Connected to browser extension for additional control",

90 icon: "chrome",

91 enabled: true,

92 connected: true,

93 manageLabel: "Manage",

94 },

95 ]}

96 showAlwaysAllowedApps={false}

97 />

98</Illustration>

99 85 

100## Start a Chrome task from ChatGPT86## Start a Chrome task from ChatGPT

101 87 

app/commands.md +254 −33

Details

6 6 

7## Keyboard shortcuts7## Keyboard shortcuts

8 8 

9| | Action | Shortcut |9Choose your platform to see its default shortcuts. Some shortcuts appear only when the corresponding feature or view is available.

10| ----------- | ------------------- | ---------------------------------------------------------------------------------------------------------------------- |10 

11| **General** | | |11### macOS

12| | Command menu | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> or <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>K</kbd> |12 

13| | Settings | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>,</kbd> |13 

14| | Keyboard shortcuts | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>/</kbd> |14 

15| | Open folder | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>O</kbd> |15| General | Shortcut |

16| | Navigate back | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>[</kbd> |16| --- | --- |

17| | Navigate forward | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>]</kbd> |17| Open command menu | **⌘+⇧+P** or **⌘+K** |

18| | Increase font size | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>+</kbd> |18| Open settings | **⌘+,** |

19| | Decrease font size | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>-</kbd> |19| Open keyboard shortcuts | **⌘+/** |

20| | Toggle sidebar | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>B</kbd> |20| Open folder (Codex and Work only) | **⌘+O** |

21| | Open review tab | <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>G</kbd> |21| Navigate back | **⌘+[** or **Mouse Back** |

22| | Toggle review panel | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>B</kbd> |22| Navigate forward | **⌘+]** or **Mouse Forward** |

23| | Toggle bottom panel | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>J</kbd> |23| Increase font size | **⌘++** or **⌘+Numpad +** |

24| | Toggle terminal | <kbd>Ctrl</kbd> + <kbd>`</kbd> |24| Decrease font size | **⌘+-** or **⌘+Numpad −** |

25| | Clear the terminal | <kbd>Ctrl</kbd> + <kbd>L</kbd> |25| Reset font size | **⌘+0** or **⌘+Numpad 0** |

26| **Chat** | Quick chat | <kbd>Cmd</kbd> + <kbd>Option</kbd> + <kbd>N</kbd> (macOS) or <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>N</kbd> (Windows) |26| Toggle sidebar | **⌘+B** |

27| | New chat | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>N</kbd> or <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>O</kbd> |27| Toggle bottom panel (Codex only) | **⌘+J** |

28| | Search chats | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>G</kbd> |28| Toggle terminal (Codex only) | **⌃+`** |

29| | Find in chat | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>F</kbd> |29| Clear terminal (When the terminal is focused) | **⌃+L** or **⌘+K** |

30| | Previous chat | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>[</kbd> |30| Clear all unread indicators (Codex only) | **⇧+Esc** |

31| | Next chat | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>]</kbd> |31| Undo last app action | **⌘+Z** |

32| **Input** | Dictation | <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>D</kbd> |32| Redo last app action | **⌘+⇧+Z** |

33 33| Close current tab or window | **⌘+W** |

34To find, customize, or reset shortcuts, open **Settings > Keyboard Shortcuts**.34| Toggle full screen | **⌘+⌃+F** |

35| Quit the app | **⌘+Q** |

36 

37| Chats | Shortcut |

38| --- | --- |

39| New chat | **⌘+N** or **⌘+⇧+O** |

40| New standalone chat (Codex only) | **⌘+⌥+O** |

41| Quick chat (ChatGPT only) | **⌘+⌥+N** |

42| New temporary chat (ChatGPT only) | **⌘+⇧+N** |

43| Archive chat | **⌘+⇧+A** |

44| Mark chat as unread | **⌘+⇧+U** |

45| Pin or unpin chat | **⌘+⌥+P** |

46| Rename chat | **⌘+⌥+R** |

47| Open side chat (Codex only) | **⌘+⌥+S** |

48| Search chats (Assign one in Settings > Keyboard Shortcuts) | Not assigned by default |

49| Find in chat | **⌘+F** |

50| Find next match | **⌘+G** |

51| Find previous match | **⌘+⇧+G** |

52| Previous chat or tab | **⌃+⇧+Tab** or **⌘+⇧+[** or **⌘+⌥+←** |

53| Next chat or tab | **⌃+Tab** or **⌘+⇧+]** or **⌘+⌥+→** |

54| Next chat needing attention (Codex only) | **⌘+⌥+A** |

55| Open recent chat 1–6 | **⌘+⌥+1–6** |

56| Go to chat 1–9 | **⌘+1–9** |

57 

58| Input and modes | Shortcut |

59| --- | --- |

60| Open model picker | **⌃+⇧+M** |

61| Open project picker | **⌘+⌥+⇧+O** |

62| Start voice chat (When voice chat is available) | **⌃+⇧+V** |

63| Start dictation (When dictation is available) | **⌃+⇧+D** |

64| Restore previous composer prompt (When the composer is empty) | **↑** |

65| Approve request (When an approval request is open) | **⏎** |

66| Decline request (When an approval request is open) | **Esc** |

67| Switch to Chat, Work, or Codex (In the order shown) | **⌃+1** or **⌃+2** or **⌃+3** |

68| Toggle Activity view (When Activity is available) | **⌘+⌥+U** |

69 

70| Workspace and browser | Shortcut |

71| --- | --- |

72| Run environment action 1 (When the environment defines a primary action) | **⌘+⇧+D** |

73| Search files (Codex only) | **⌘+P** |

74| Toggle file tree (Codex only) | **⌘+⇧+E** |

75| Open review tab (Codex only) | **⌃+⇧+G** |

76| Toggle review panel (Codex only) | **⌘+⌥+B** |

77| Open browser tab (When the built-in browser is available) | **⌘+T** |

78| Toggle browser panel (When the built-in browser is available) | **⌘+⇧+B** |

79| Go to line or focus browser address bar (Depends on the focused view) | **⌘+L** |

80| Browser back (When the built-in browser is focused) | **⌘+←** |

81| Browser forward (When the built-in browser is focused) | **⌘+→** |

82| Reload browser page (When the built-in browser is focused) | **⌘+R** |

83| Reload browser page without cache (When the built-in browser is focused) | **⌘+⇧+R** |

84| Copy browser URL (When the built-in browser is focused) | **⌘+⇧+C** |

85| Toggle browser browse or comment mode (When browser commenting is available) | **⌘+.** |

86| Copy conversation path (Codex only) | **⌘+⌥+⇧+C** |

87| Copy chat deep link | **⌘+⌥+L** |

88| Copy session ID | **⌘+⌥+C** |

89| Copy working directory (Codex only) | **⌘+⇧+C** |

90| Take an Appshot (press both keys simultaneously) | **⌘+⌘** |

91 

92### Windows

93 

94 

95 

96| General | Shortcut |

97| --- | --- |

98| Open command menu | **Ctrl+Shift+P** or **Ctrl+K** |

99| Open settings | **Ctrl+,** |

100| Open keyboard shortcuts | **Ctrl+/** |

101| Open folder (Codex and Work only) | **Ctrl+O** |

102| Navigate back | **Ctrl+[** or **Mouse Back** |

103| Navigate forward | **Ctrl+]** or **Mouse Forward** |

104| Increase font size | **Ctrl++** or **Ctrl+=** or **Ctrl+Numpad +** |

105| Decrease font size | **Ctrl+-** or **Ctrl+Numpad −** |

106| Reset font size | **Ctrl+0** or **Ctrl+Numpad 0** |

107| Toggle sidebar | **Ctrl+B** |

108| Toggle bottom panel (Codex only) | **Ctrl+J** |

109| Toggle terminal (Codex only) | **Ctrl+`** |

110| Clear terminal (When the terminal is focused) | **Ctrl+L** or **Ctrl+K** |

111| Clear all unread indicators (Codex only) | **Shift+Esc** |

112| Undo last app action | **Ctrl+Z** |

113| Redo last app action | **Ctrl+Y** or **Ctrl+Shift+Z** |

114| Close current tab or window | **Ctrl+W** or **Ctrl+F4** |

115| Toggle full screen | **F11** |

116| Quit the app | **Ctrl+Q** |

117 

118| Chats | Shortcut |

119| --- | --- |

120| New chat | **Ctrl+N** or **Ctrl+Shift+O** |

121| New standalone chat (Codex only) | **Ctrl+Alt+O** |

122| Quick chat (ChatGPT only) | **Ctrl+Alt+N** |

123| New temporary chat (ChatGPT only) | **Ctrl+Shift+N** |

124| Archive chat | **Ctrl+Shift+A** |

125| Mark chat as unread | **Ctrl+Shift+U** |

126| Pin or unpin chat | **Ctrl+Alt+P** |

127| Rename chat | **Ctrl+Alt+R** |

128| Open side chat (Codex only) | **Ctrl+Alt+S** |

129| Search chats (Assign one in Settings > Keyboard Shortcuts) | Not assigned by default |

130| Find in chat | **Ctrl+F** |

131| Find next match | **Ctrl+G** |

132| Find previous match | **Shift+F3** |

133| Previous chat or tab | **Ctrl+Shift+Tab** or **Ctrl+Shift+[** or **Ctrl+Page Up** |

134| Next chat or tab | **Ctrl+Tab** or **Ctrl+Shift+]** or **Ctrl+Page Down** |

135| Next chat needing attention (Codex only) | **Ctrl+Alt+A** |

136| Open recent chat 1–6 | **Ctrl+Alt+1–6** |

137| Go to chat 1–9 | **Ctrl+1–9** |

138 

139| Input and modes | Shortcut |

140| --- | --- |

141| Open model picker | **Ctrl+Shift+M** |

142| Open project picker | **Ctrl+Alt+Shift+O** |

143| Start voice chat (When voice chat is available) | **Ctrl+Shift+V** |

144| Start dictation (When dictation is available) | **Ctrl+Shift+D** |

145| Restore previous composer prompt (When the composer is empty) | **↑** |

146| Approve request (When an approval request is open) | **⏎** |

147| Decline request (When an approval request is open) | **Esc** |

148| Switch to Chat, Work, or Codex (In the order shown) | **Alt+1** or **Alt+2** or **Alt+3** |

149| Toggle Activity view (When Activity is available) | **Ctrl+Alt+U** |

150 

151| Workspace and browser | Shortcut |

152| --- | --- |

153| Run environment action 1 (When the environment defines a primary action) | **Win+Shift+D** |

154| Search files (Codex only) | **Ctrl+P** |

155| Toggle file tree (Codex only) | **Ctrl+Shift+E** |

156| Open review tab (Codex only) | **Ctrl+Shift+G** |

157| Toggle review panel (Codex only) | **Ctrl+Alt+B** |

158| Open browser tab (When the built-in browser is available) | **Ctrl+T** |

159| Toggle browser panel (When the built-in browser is available) | **Ctrl+Shift+B** |

160| Go to line or focus browser address bar (Depends on the focused view) | **Ctrl+L** |

161| Browser back (When the built-in browser is focused) | **Alt+←** |

162| Browser forward (When the built-in browser is focused) | **Alt+→** |

163| Reload browser page (When the built-in browser is focused) | **Ctrl+R** |

164| Reload browser page without cache (When the built-in browser is focused) | **Ctrl+Shift+R** |

165| Copy browser URL (When the built-in browser is focused) | **Ctrl+Shift+C** |

166| Toggle browser browse or comment mode (When browser commenting is available) | **Ctrl+.** |

167| Copy chat deep link | **Ctrl+Alt+L** |

168| Copy session ID | **Ctrl+Alt+C** |

169| Copy working directory (Codex only) | **Ctrl+Shift+C** |

170 

171### Linux

172 

173 

174 

175| General | Shortcut |

176| --- | --- |

177| Open command menu | **Ctrl+Shift+P** or **Ctrl+K** |

178| Open settings | **Ctrl+,** |

179| Open keyboard shortcuts | **Ctrl+/** |

180| Open folder (Codex and Work only) | **Ctrl+O** |

181| Navigate back | **Ctrl+[** or **Mouse Back** |

182| Navigate forward | **Ctrl+]** or **Mouse Forward** |

183| Increase font size | **Ctrl++** or **Ctrl+=** or **Ctrl+Numpad +** |

184| Decrease font size | **Ctrl+-** or **Ctrl+Numpad −** |

185| Reset font size | **Ctrl+0** or **Ctrl+Numpad 0** |

186| Toggle sidebar | **Ctrl+B** |

187| Toggle bottom panel (Codex only) | **Ctrl+J** |

188| Toggle terminal (Codex only) | **Ctrl+`** |

189| Clear terminal (When the terminal is focused) | **Ctrl+L** or **Ctrl+K** |

190| Clear all unread indicators (Codex only) | **Shift+Esc** |

191| Undo last app action | **Ctrl+Z** |

192| Redo last app action | **Ctrl+Y** or **Ctrl+Shift+Z** |

193| Close current tab or window | **Ctrl+W** or **Ctrl+F4** |

194| Toggle full screen | **F11** |

195| Quit the app | **Ctrl+Q** |

196 

197| Chats | Shortcut |

198| --- | --- |

199| New chat | **Ctrl+N** or **Ctrl+Shift+O** |

200| New standalone chat (Codex only) | **Ctrl+Alt+O** |

201| Quick chat (ChatGPT only) | **Ctrl+Alt+N** |

202| New temporary chat (ChatGPT only) | **Ctrl+Shift+N** |

203| Archive chat | **Ctrl+Shift+A** |

204| Mark chat as unread | **Ctrl+Shift+U** |

205| Pin or unpin chat | **Ctrl+Alt+P** |

206| Rename chat | **Ctrl+Alt+R** |

207| Open side chat (Codex only) | **Ctrl+Alt+S** |

208| Search chats (Assign one in Settings > Keyboard Shortcuts) | Not assigned by default |

209| Find in chat | **Ctrl+F** |

210| Find next match | **Ctrl+G** |

211| Find previous match | **Shift+F3** |

212| Previous chat or tab | **Ctrl+Shift+Tab** or **Ctrl+Shift+[** or **Ctrl+Page Up** |

213| Next chat or tab | **Ctrl+Tab** or **Ctrl+Shift+]** or **Ctrl+Page Down** |

214| Next chat needing attention (Codex only) | **Ctrl+Alt+A** |

215| Open recent chat 1–6 | **Ctrl+Alt+1–6** |

216| Go to chat 1–9 | **Ctrl+1–9** |

217 

218| Input and modes | Shortcut |

219| --- | --- |

220| Open model picker | **Ctrl+Shift+M** |

221| Open project picker | **Ctrl+Alt+Shift+O** |

222| Start voice chat (When voice chat is available) | **Ctrl+Shift+V** |

223| Start dictation (When dictation is available) | **Ctrl+Shift+D** |

224| Restore previous composer prompt (When the composer is empty) | **↑** |

225| Approve request (When an approval request is open) | **⏎** |

226| Decline request (When an approval request is open) | **Esc** |

227| Switch to Chat, Work, or Codex (In the order shown) | **Alt+1** or **Alt+2** or **Alt+3** |

228| Toggle Activity view (When Activity is available) | **Ctrl+Alt+U** |

229 

230| Workspace and browser | Shortcut |

231| --- | --- |

232| Run environment action 1 (When the environment defines a primary action) | **Super+Shift+D** |

233| Search files (Codex only) | **Ctrl+P** |

234| Toggle file tree (Codex only) | **Ctrl+Shift+E** |

235| Open review tab (Codex only) | **Ctrl+Shift+G** |

236| Toggle review panel (Codex only) | **Ctrl+Alt+B** |

237| Open browser tab (When the built-in browser is available) | **Ctrl+T** |

238| Toggle browser panel (When the built-in browser is available) | **Ctrl+Shift+B** |

239| Go to line or focus browser address bar (Depends on the focused view) | **Ctrl+L** |

240| Browser back (When the built-in browser is focused) | **Alt+←** |

241| Browser forward (When the built-in browser is focused) | **Alt+→** |

242| Reload browser page (When the built-in browser is focused) | **Ctrl+R** |

243| Reload browser page without cache (When the built-in browser is focused) | **Ctrl+Shift+R** |

244| Copy browser URL (When the built-in browser is focused) | **Ctrl+Shift+C** |

245| Toggle browser browse or comment mode (When browser commenting is available) | **Ctrl+.** |

246| Copy chat deep link | **Ctrl+Alt+L** |

247| Copy session ID | **Ctrl+Alt+C** |

248| Copy working directory (Codex only) | **Ctrl+Shift+C** |To find, customize, or reset app shortcuts, open **Settings > Keyboard

249Shortcuts**.

250 

35You can search by command name or switch the search field into keystroke mode251You can search by command name or switch the search field into keystroke mode

36and press the shortcut you want to find.252and press the shortcut you want to find. Appshots use a separate global shortcut

253under **Settings > Appshots**.

254 

255On Linux, experimental native Wayland can affect shortcut support. See the

256[Linux desktop app guide](https://learn.chatgpt.com/docs/linux/linux-app#wayland-support).

37 257 

38<a id="search-past-tasks-and-find-in-a-task"></a>258<a id="search-past-tasks-and-find-in-a-task"></a>

39 259 

40## Search past chats and find in a chat260## Search past chats and find in a chat

41 261 

42Use chat search (<kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>G</kbd>) to reopen a past262Use **Search chats** to reopen a past chat. Search chats doesn't have a default

43chat. When expanded matching is available, it can also match chat content and263shortcut. You can assign one under **Settings > Keyboard Shortcuts**. When

44Git branch names, so you can search for a phrase from the chat or a264expanded matching is available, search can also match chat content and Git

45branch such as `fix/login-redirect`.265branch names, so you can search for a phrase from the chat or a branch such as

266`fix/login-redirect`.

46 267 

47Use **Find in chat** (<kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>F</kbd>) after opening268Use **Find in chat** after opening a chat to find text within it. It doesn't

48a chat to find text within it. It doesn't search across other chats.269search across other chats.

49 270 

50For actions that start with `/`, see [Slash commands](https://learn.chatgpt.com/docs/reference/slash-commands).271For actions that start with `/`, see [Slash commands](https://learn.chatgpt.com/docs/reference/slash-commands).

51 272 

Details

25select it. Turn on the Computer Use server and skill toggles, then select **Try25select it. Turn on the Computer Use server and skill toggles, then select **Try

26now** to start.26now** to start.

27 27 

28<Illustration description="Computer Use plugin controls with the MCP server and skill enabled.">28 

29 <ComputerUsePluginSetupIllustration ariaLabel="Computer Use plugin controls with the MCP server and skill enabled." />29 

30</Illustration>30> Illustration: Computer Use plugin controls with the MCP server and skill enabled.

31 

32 

31 33 

32Then open **Settings > Computer use** to review app access. Connected browser34Then open **Settings > Computer use** to review app access. Connected browser

33controls show a **Manage** action. Apps you approve for future tasks appear in35controls show a **Manage** action. Apps you approve for future tasks appear in

34the **Always-allowed apps** section.36the **Always-allowed apps** section.

35 37 

36<Illustration description="Computer Use settings showing app controls and Calculator as the only always-allowed app.">38 

37 <ComputerUseSettingsIllustration ariaLabel="Computer Use settings showing app controls and Calculator as the only always-allowed app." />39 

38</Illustration>40> Illustration: Computer Use settings showing app controls and Calculator as the only always-allowed app.

41 

42 

39 43 

40On Windows, keep the target app visible on the active desktop while the task44On Windows, keep the target app visible on the active desktop while the task

41runs. On macOS, grant Screen Recording and Accessibility permissions when45runs. On macOS, grant Screen Recording and Accessibility permissions when


112without asking again. You can remove apps from the **Always allow** list in the116without asking again. You can remove apps from the **Always allow** list in the

113**Computer Use** section of the ChatGPT desktop app settings.117**Computer Use** section of the ChatGPT desktop app settings.

114 118 

115<CodexScreenshot119 

116 alt="ChatGPT desktop app asking for permission to use Calculator with Computer Use"120

117 lightSrc="/images/codex/app/computer-use-approval-light.webp"121 

118 darkSrc="/images/codex/app/computer-use-approval-dark.webp"122> Illustration: Computer Use approval dialog requesting access to Calculator

119 maxHeight="420px"123 

120 variant="no-wallpaper"124 

121/>125 

122 126 

123ChatGPT may also ask for permission before taking sensitive or disruptive actions.127ChatGPT may also ask for permission before taking sensitive or disruptive actions.

124 128 

Details

41 41 

42 42 

43 43 

44<CodexScreenshot44 

45 alt="Project actions list shown in ChatGPT desktop app settings"45

46 lightSrc="/images/codex/app/actions-light.webp"46 

47 darkSrc="/images/codex/app/actions-dark.webp"47> Illustration: Project actions list shown in ChatGPT desktop app settings

48 maxHeight="400px"48 

49 class="mb-4 lg:mb-0"49 

50/>50 

51 51 

52</section>52</section>

53 53 


82 82 

83 83 

84 84 

85<Illustration description="Codex environment summary panel">85 

86 <EnvironmentPanelIllustration ariaLabel="Codex environment summary panel" />86 

87</Illustration>87> Illustration: Codex environment summary panel

app/review.md +7 −6

Details

125**Code review**, choose **Detached** to start a separate review chat. See125**Code review**, choose **Detached** to start a separate review chat. See

126[developer settings](https://learn.chatgpt.com/docs/developer-settings?surface=app#app-code-review).126[developer settings](https://learn.chatgpt.com/docs/developer-settings?surface=app#app-code-review).

127 127 

128<CodexScreenshot128 

129 alt="Inline code review comments displayed in the review pane"129

130 lightSrc="/images/codex/app/inline-code-review-light.webp"130 

131 darkSrc="/images/codex/app/inline-code-review-dark.webp"131> Illustration: Inline code review comments displayed in the review pane

132 maxHeight="400px"132 

133/>133 

134 

134 135 

135</ContentModeSwitch>136</ContentModeSwitch>

136 137 

app/settings.md +11 −14

Details

46adjusting accent, background, and foreground colors, and changing the UI and46adjusting accent, background, and foreground colors, and changing the UI and

47code fonts. You can also share your custom theme with friends.47code fonts. You can also share your custom theme with friends.

48 48 

49<CodexScreenshot49 

50 alt="ChatGPT desktop app Appearance settings showing theme selection, color controls, and font options"50

51 lightSrc="/images/codex/app/theme-selection-light.webp"51 

52 darkSrc="/images/codex/app/theme-selection-dark.webp"52> Illustration: ChatGPT desktop app Appearance settings showing theme selection, color controls, and font options

53 maxHeight="720px"53 

54 class="mb-8"54 

55/>55 

56 56 

57## Pets57## Pets

58 58 


128next to your browser, editor, or design preview. Turn on **Always on top** when128next to your browser, editor, or design preview. Turn on **Always on top** when

129you want the chat to remain visible while you work in another app.129you want the chat to remain visible while you work in another app.

130 130 

131<CodexScreenshot131 

132 alt="ChatGPT desktop app chat displayed in a floating pop-out window"132

133 lightSrc="/images/codex/app/popover-light.webp"133 

134 darkSrc="/images/codex/app/popover-dark.webp"134> Illustration: ChatGPT desktop app chat displayed in a floating pop-out window

135 maxHeight="400px"

136 class="my-8"

137/>

app/windows.md +28 −29

Details

10[Windows sandbox](https://learn.chatgpt.com/docs/windows/windows-sandbox#windows-sandbox), or you can configure it to10[Windows sandbox](https://learn.chatgpt.com/docs/windows/windows-sandbox#windows-sandbox), or you can configure it to

11run in [Windows Subsystem for Linux 2 (WSL2)](#windows-subsystem-for-linux-wsl).11run in [Windows Subsystem for Linux 2 (WSL2)](#windows-subsystem-for-linux-wsl).

12 12 

13<CodexScreenshot13 

14 alt="ChatGPT desktop app for Windows showing a project sidebar, active chat, and review pane"14

15 lightSrc="/images/codex/windows/codex-windows-light.webp"15 

16 darkSrc="/images/codex/windows/codex-windows-dark.webp"16> Illustration: ChatGPT desktop app for Windows showing a project sidebar, active chat, and review pane

17 variant="no-wallpaper"17 

18 maxHeight="320px"18 

19/>19 

20 20 

21## Download the ChatGPT desktop app21## Download the ChatGPT desktop app

22 22 


63 63 

64 64 

65 65 

66<CodexScreenshot66 

67 alt="ChatGPT desktop app settings showing the default Open In app on Windows"67

68 lightSrc="/images/codex/windows/open-in-windows-light.webp"68 

69 darkSrc="/images/codex/windows/open-in-windows-dark.webp"69> Illustration: ChatGPT desktop app settings showing the default Open In app on Windows

70 maxHeight={520}70 

71 maxWidth={784}71 

72/>72 

73 73 

74</section>74</section>

75 75 


95 95 

96 96 

97 97 

98<CodexScreenshot98 

99 alt="ChatGPT desktop app settings showing the integrated terminal selection on Windows"99

100 lightSrc="/images/codex/windows/integrated-shell-light.webp"100 

101 darkSrc="/images/codex/windows/integrated-shell-dark.webp"101> Illustration: ChatGPT desktop app settings showing the integrated terminal selection on Windows

102 maxHeight={520}102 

103 maxWidth={788}103 

104/>104 

105 105 

106</section>106</section>

107 107 


129WSL1 was supported through Codex `0.114`. Starting in Codex `0.115`, the Linux129WSL1 was supported through Codex `0.114`. Starting in Codex `0.115`, the Linux

130sandbox moved to `bubblewrap`, so WSL1 is no longer supported.130sandbox moved to `bubblewrap`, so WSL1 is no longer supported.

131 131 

132<CodexScreenshot132 

133 alt="ChatGPT desktop app settings showing the agent selector with Windows native and WSL options"133

134 lightSrc="/images/codex/windows/wsl-select-light.webp"134 

135 darkSrc="/images/codex/windows/wsl-select-dark.webp"135> Illustration: ChatGPT desktop app settings showing the agent selector with Windows native and WSL options

136 maxHeight={520}136 

137 maxWidth={786}137 

138 class="mb-8"138 

139/>

140 139 

141You configure the integrated terminal independently from the agent. See140You configure the integrated terminal independently from the agent. See

142[Customize for your dev setup](#customize-for-your-dev-setup) for the141[Customize for your dev setup](#customize-for-your-dev-setup) for the

app/worktrees.md +14 −14

Details

80 80 

81 81 

82 82 

83<CodexScreenshot83 

84 alt="Worktree chat view with branch controls and worktree details"84

85 lightSrc="/images/codex/app/worktree-light.webp"85 

86 darkSrc="/images/codex/app/worktree-dark.webp"86> Illustration: Worktree chat view with branch controls and worktree details

87 maxHeight="400px"87 

88 class="mb-4 lg:mb-0"88 

89/>89 

90 90 

91 91 

92 92 


116 116 

117 117 

118 118 

119<CodexScreenshot119 

120 alt="Handoff dialog moving a chat from a worktree to Local"120

121 lightSrc="/images/codex/app/handoff-light.webp"121 

122 darkSrc="/images/codex/app/handoff-dark.webp"122> Illustration: Handoff dialog moving a chat from a worktree to Local

123 maxHeight="400px"123 

124 class="mb-4 lg:mb-0"124 

125/>125 

126 126 

127 127 

128 128 

appshots.md +5 −3

Details

423. Allow macOS permissions if ChatGPT asks.423. Allow macOS permissions if ChatGPT asks.

434. Ask ChatGPT to perform a task with the appshot.434. Ask ChatGPT to perform a task with the appshot.

44 44 

45<Illustration description="ChatGPT chat composer with an Appshot attachment and follow-up prompt">45 

46 <AppshotsComposerIllustration ariaLabel="ChatGPT chat composer with an Appshot attachment and follow-up prompt" />46 

47</Illustration>47> Illustration: ChatGPT chat composer with an Appshot attachment and follow-up prompt

48 

49 

48 50 

49By default, ChatGPT starts a new chat for the appshot. If you interacted with a51By default, ChatGPT starts a new chat for the appshot. If you interacted with a

50chat in the last 60 seconds, ChatGPT adds the appshot to that recent52chat in the last 60 seconds, ChatGPT adds the appshot to that recent

Details

52 52 

53<ContentModeSwitch group="codex-surface" id="app">53<ContentModeSwitch group="codex-surface" id="app">

54 54 

55<CodexScreenshot55 

56 alt="ChatGPT desktop app showing a generated presentation preview"56

57 lightSrc="/images/codex/app/artifact-viewer-light.webp"57 

58 darkSrc="/images/codex/app/artifact-viewer-dark.webp"58> Illustration: ChatGPT desktop app showing a generated presentation preview

59 maxHeight="420px"59 

60 variant="no-wallpaper"60 

61 class="my-8"61 

62/>

63 62 

64</ContentModeSwitch>63</ContentModeSwitch>

65 64 

cli/reference.md +254 −33

Details

6 6 

7## Keyboard shortcuts7## Keyboard shortcuts

8 8 

9| | Action | Shortcut |9Choose your platform to see its default shortcuts. Some shortcuts appear only when the corresponding feature or view is available.

10| ----------- | ------------------- | ---------------------------------------------------------------------------------------------------------------------- |10 

11| **General** | | |11### macOS

12| | Command menu | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> or <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>K</kbd> |12 

13| | Settings | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>,</kbd> |13 

14| | Keyboard shortcuts | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>/</kbd> |14 

15| | Open folder | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>O</kbd> |15| General | Shortcut |

16| | Navigate back | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>[</kbd> |16| --- | --- |

17| | Navigate forward | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>]</kbd> |17| Open command menu | **⌘+⇧+P** or **⌘+K** |

18| | Increase font size | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>+</kbd> |18| Open settings | **⌘+,** |

19| | Decrease font size | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>-</kbd> |19| Open keyboard shortcuts | **⌘+/** |

20| | Toggle sidebar | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>B</kbd> |20| Open folder (Codex and Work only) | **⌘+O** |

21| | Open review tab | <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>G</kbd> |21| Navigate back | **⌘+[** or **Mouse Back** |

22| | Toggle review panel | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>B</kbd> |22| Navigate forward | **⌘+]** or **Mouse Forward** |

23| | Toggle bottom panel | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>J</kbd> |23| Increase font size | **⌘++** or **⌘+Numpad +** |

24| | Toggle terminal | <kbd>Ctrl</kbd> + <kbd>`</kbd> |24| Decrease font size | **⌘+-** or **⌘+Numpad −** |

25| | Clear the terminal | <kbd>Ctrl</kbd> + <kbd>L</kbd> |25| Reset font size | **⌘+0** or **⌘+Numpad 0** |

26| **Chat** | Quick chat | <kbd>Cmd</kbd> + <kbd>Option</kbd> + <kbd>N</kbd> (macOS) or <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>N</kbd> (Windows) |26| Toggle sidebar | **⌘+B** |

27| | New chat | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>N</kbd> or <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>O</kbd> |27| Toggle bottom panel (Codex only) | **⌘+J** |

28| | Search chats | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>G</kbd> |28| Toggle terminal (Codex only) | **⌃+`** |

29| | Find in chat | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>F</kbd> |29| Clear terminal (When the terminal is focused) | **⌃+L** or **⌘+K** |

30| | Previous chat | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>[</kbd> |30| Clear all unread indicators (Codex only) | **⇧+Esc** |

31| | Next chat | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>]</kbd> |31| Undo last app action | **⌘+Z** |

32| **Input** | Dictation | <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>D</kbd> |32| Redo last app action | **⌘+⇧+Z** |

33 33| Close current tab or window | **⌘+W** |

34To find, customize, or reset shortcuts, open **Settings > Keyboard Shortcuts**.34| Toggle full screen | **⌘+⌃+F** |

35| Quit the app | **⌘+Q** |

36 

37| Chats | Shortcut |

38| --- | --- |

39| New chat | **⌘+N** or **⌘+⇧+O** |

40| New standalone chat (Codex only) | **⌘+⌥+O** |

41| Quick chat (ChatGPT only) | **⌘+⌥+N** |

42| New temporary chat (ChatGPT only) | **⌘+⇧+N** |

43| Archive chat | **⌘+⇧+A** |

44| Mark chat as unread | **⌘+⇧+U** |

45| Pin or unpin chat | **⌘+⌥+P** |

46| Rename chat | **⌘+⌥+R** |

47| Open side chat (Codex only) | **⌘+⌥+S** |

48| Search chats (Assign one in Settings > Keyboard Shortcuts) | Not assigned by default |

49| Find in chat | **⌘+F** |

50| Find next match | **⌘+G** |

51| Find previous match | **⌘+⇧+G** |

52| Previous chat or tab | **⌃+⇧+Tab** or **⌘+⇧+[** or **⌘+⌥+←** |

53| Next chat or tab | **⌃+Tab** or **⌘+⇧+]** or **⌘+⌥+→** |

54| Next chat needing attention (Codex only) | **⌘+⌥+A** |

55| Open recent chat 1–6 | **⌘+⌥+1–6** |

56| Go to chat 1–9 | **⌘+1–9** |

57 

58| Input and modes | Shortcut |

59| --- | --- |

60| Open model picker | **⌃+⇧+M** |

61| Open project picker | **⌘+⌥+⇧+O** |

62| Start voice chat (When voice chat is available) | **⌃+⇧+V** |

63| Start dictation (When dictation is available) | **⌃+⇧+D** |

64| Restore previous composer prompt (When the composer is empty) | **↑** |

65| Approve request (When an approval request is open) | **⏎** |

66| Decline request (When an approval request is open) | **Esc** |

67| Switch to Chat, Work, or Codex (In the order shown) | **⌃+1** or **⌃+2** or **⌃+3** |

68| Toggle Activity view (When Activity is available) | **⌘+⌥+U** |

69 

70| Workspace and browser | Shortcut |

71| --- | --- |

72| Run environment action 1 (When the environment defines a primary action) | **⌘+⇧+D** |

73| Search files (Codex only) | **⌘+P** |

74| Toggle file tree (Codex only) | **⌘+⇧+E** |

75| Open review tab (Codex only) | **⌃+⇧+G** |

76| Toggle review panel (Codex only) | **⌘+⌥+B** |

77| Open browser tab (When the built-in browser is available) | **⌘+T** |

78| Toggle browser panel (When the built-in browser is available) | **⌘+⇧+B** |

79| Go to line or focus browser address bar (Depends on the focused view) | **⌘+L** |

80| Browser back (When the built-in browser is focused) | **⌘+←** |

81| Browser forward (When the built-in browser is focused) | **⌘+→** |

82| Reload browser page (When the built-in browser is focused) | **⌘+R** |

83| Reload browser page without cache (When the built-in browser is focused) | **⌘+⇧+R** |

84| Copy browser URL (When the built-in browser is focused) | **⌘+⇧+C** |

85| Toggle browser browse or comment mode (When browser commenting is available) | **⌘+.** |

86| Copy conversation path (Codex only) | **⌘+⌥+⇧+C** |

87| Copy chat deep link | **⌘+⌥+L** |

88| Copy session ID | **⌘+⌥+C** |

89| Copy working directory (Codex only) | **⌘+⇧+C** |

90| Take an Appshot (press both keys simultaneously) | **⌘+⌘** |

91 

92### Windows

93 

94 

95 

96| General | Shortcut |

97| --- | --- |

98| Open command menu | **Ctrl+Shift+P** or **Ctrl+K** |

99| Open settings | **Ctrl+,** |

100| Open keyboard shortcuts | **Ctrl+/** |

101| Open folder (Codex and Work only) | **Ctrl+O** |

102| Navigate back | **Ctrl+[** or **Mouse Back** |

103| Navigate forward | **Ctrl+]** or **Mouse Forward** |

104| Increase font size | **Ctrl++** or **Ctrl+=** or **Ctrl+Numpad +** |

105| Decrease font size | **Ctrl+-** or **Ctrl+Numpad −** |

106| Reset font size | **Ctrl+0** or **Ctrl+Numpad 0** |

107| Toggle sidebar | **Ctrl+B** |

108| Toggle bottom panel (Codex only) | **Ctrl+J** |

109| Toggle terminal (Codex only) | **Ctrl+`** |

110| Clear terminal (When the terminal is focused) | **Ctrl+L** or **Ctrl+K** |

111| Clear all unread indicators (Codex only) | **Shift+Esc** |

112| Undo last app action | **Ctrl+Z** |

113| Redo last app action | **Ctrl+Y** or **Ctrl+Shift+Z** |

114| Close current tab or window | **Ctrl+W** or **Ctrl+F4** |

115| Toggle full screen | **F11** |

116| Quit the app | **Ctrl+Q** |

117 

118| Chats | Shortcut |

119| --- | --- |

120| New chat | **Ctrl+N** or **Ctrl+Shift+O** |

121| New standalone chat (Codex only) | **Ctrl+Alt+O** |

122| Quick chat (ChatGPT only) | **Ctrl+Alt+N** |

123| New temporary chat (ChatGPT only) | **Ctrl+Shift+N** |

124| Archive chat | **Ctrl+Shift+A** |

125| Mark chat as unread | **Ctrl+Shift+U** |

126| Pin or unpin chat | **Ctrl+Alt+P** |

127| Rename chat | **Ctrl+Alt+R** |

128| Open side chat (Codex only) | **Ctrl+Alt+S** |

129| Search chats (Assign one in Settings > Keyboard Shortcuts) | Not assigned by default |

130| Find in chat | **Ctrl+F** |

131| Find next match | **Ctrl+G** |

132| Find previous match | **Shift+F3** |

133| Previous chat or tab | **Ctrl+Shift+Tab** or **Ctrl+Shift+[** or **Ctrl+Page Up** |

134| Next chat or tab | **Ctrl+Tab** or **Ctrl+Shift+]** or **Ctrl+Page Down** |

135| Next chat needing attention (Codex only) | **Ctrl+Alt+A** |

136| Open recent chat 1–6 | **Ctrl+Alt+1–6** |

137| Go to chat 1–9 | **Ctrl+1–9** |

138 

139| Input and modes | Shortcut |

140| --- | --- |

141| Open model picker | **Ctrl+Shift+M** |

142| Open project picker | **Ctrl+Alt+Shift+O** |

143| Start voice chat (When voice chat is available) | **Ctrl+Shift+V** |

144| Start dictation (When dictation is available) | **Ctrl+Shift+D** |

145| Restore previous composer prompt (When the composer is empty) | **↑** |

146| Approve request (When an approval request is open) | **⏎** |

147| Decline request (When an approval request is open) | **Esc** |

148| Switch to Chat, Work, or Codex (In the order shown) | **Alt+1** or **Alt+2** or **Alt+3** |

149| Toggle Activity view (When Activity is available) | **Ctrl+Alt+U** |

150 

151| Workspace and browser | Shortcut |

152| --- | --- |

153| Run environment action 1 (When the environment defines a primary action) | **Win+Shift+D** |

154| Search files (Codex only) | **Ctrl+P** |

155| Toggle file tree (Codex only) | **Ctrl+Shift+E** |

156| Open review tab (Codex only) | **Ctrl+Shift+G** |

157| Toggle review panel (Codex only) | **Ctrl+Alt+B** |

158| Open browser tab (When the built-in browser is available) | **Ctrl+T** |

159| Toggle browser panel (When the built-in browser is available) | **Ctrl+Shift+B** |

160| Go to line or focus browser address bar (Depends on the focused view) | **Ctrl+L** |

161| Browser back (When the built-in browser is focused) | **Alt+←** |

162| Browser forward (When the built-in browser is focused) | **Alt+→** |

163| Reload browser page (When the built-in browser is focused) | **Ctrl+R** |

164| Reload browser page without cache (When the built-in browser is focused) | **Ctrl+Shift+R** |

165| Copy browser URL (When the built-in browser is focused) | **Ctrl+Shift+C** |

166| Toggle browser browse or comment mode (When browser commenting is available) | **Ctrl+.** |

167| Copy chat deep link | **Ctrl+Alt+L** |

168| Copy session ID | **Ctrl+Alt+C** |

169| Copy working directory (Codex only) | **Ctrl+Shift+C** |

170 

171### Linux

172 

173 

174 

175| General | Shortcut |

176| --- | --- |

177| Open command menu | **Ctrl+Shift+P** or **Ctrl+K** |

178| Open settings | **Ctrl+,** |

179| Open keyboard shortcuts | **Ctrl+/** |

180| Open folder (Codex and Work only) | **Ctrl+O** |

181| Navigate back | **Ctrl+[** or **Mouse Back** |

182| Navigate forward | **Ctrl+]** or **Mouse Forward** |

183| Increase font size | **Ctrl++** or **Ctrl+=** or **Ctrl+Numpad +** |

184| Decrease font size | **Ctrl+-** or **Ctrl+Numpad −** |

185| Reset font size | **Ctrl+0** or **Ctrl+Numpad 0** |

186| Toggle sidebar | **Ctrl+B** |

187| Toggle bottom panel (Codex only) | **Ctrl+J** |

188| Toggle terminal (Codex only) | **Ctrl+`** |

189| Clear terminal (When the terminal is focused) | **Ctrl+L** or **Ctrl+K** |

190| Clear all unread indicators (Codex only) | **Shift+Esc** |

191| Undo last app action | **Ctrl+Z** |

192| Redo last app action | **Ctrl+Y** or **Ctrl+Shift+Z** |

193| Close current tab or window | **Ctrl+W** or **Ctrl+F4** |

194| Toggle full screen | **F11** |

195| Quit the app | **Ctrl+Q** |

196 

197| Chats | Shortcut |

198| --- | --- |

199| New chat | **Ctrl+N** or **Ctrl+Shift+O** |

200| New standalone chat (Codex only) | **Ctrl+Alt+O** |

201| Quick chat (ChatGPT only) | **Ctrl+Alt+N** |

202| New temporary chat (ChatGPT only) | **Ctrl+Shift+N** |

203| Archive chat | **Ctrl+Shift+A** |

204| Mark chat as unread | **Ctrl+Shift+U** |

205| Pin or unpin chat | **Ctrl+Alt+P** |

206| Rename chat | **Ctrl+Alt+R** |

207| Open side chat (Codex only) | **Ctrl+Alt+S** |

208| Search chats (Assign one in Settings > Keyboard Shortcuts) | Not assigned by default |

209| Find in chat | **Ctrl+F** |

210| Find next match | **Ctrl+G** |

211| Find previous match | **Shift+F3** |

212| Previous chat or tab | **Ctrl+Shift+Tab** or **Ctrl+Shift+[** or **Ctrl+Page Up** |

213| Next chat or tab | **Ctrl+Tab** or **Ctrl+Shift+]** or **Ctrl+Page Down** |

214| Next chat needing attention (Codex only) | **Ctrl+Alt+A** |

215| Open recent chat 1–6 | **Ctrl+Alt+1–6** |

216| Go to chat 1–9 | **Ctrl+1–9** |

217 

218| Input and modes | Shortcut |

219| --- | --- |

220| Open model picker | **Ctrl+Shift+M** |

221| Open project picker | **Ctrl+Alt+Shift+O** |

222| Start voice chat (When voice chat is available) | **Ctrl+Shift+V** |

223| Start dictation (When dictation is available) | **Ctrl+Shift+D** |

224| Restore previous composer prompt (When the composer is empty) | **↑** |

225| Approve request (When an approval request is open) | **⏎** |

226| Decline request (When an approval request is open) | **Esc** |

227| Switch to Chat, Work, or Codex (In the order shown) | **Alt+1** or **Alt+2** or **Alt+3** |

228| Toggle Activity view (When Activity is available) | **Ctrl+Alt+U** |

229 

230| Workspace and browser | Shortcut |

231| --- | --- |

232| Run environment action 1 (When the environment defines a primary action) | **Super+Shift+D** |

233| Search files (Codex only) | **Ctrl+P** |

234| Toggle file tree (Codex only) | **Ctrl+Shift+E** |

235| Open review tab (Codex only) | **Ctrl+Shift+G** |

236| Toggle review panel (Codex only) | **Ctrl+Alt+B** |

237| Open browser tab (When the built-in browser is available) | **Ctrl+T** |

238| Toggle browser panel (When the built-in browser is available) | **Ctrl+Shift+B** |

239| Go to line or focus browser address bar (Depends on the focused view) | **Ctrl+L** |

240| Browser back (When the built-in browser is focused) | **Alt+←** |

241| Browser forward (When the built-in browser is focused) | **Alt+→** |

242| Reload browser page (When the built-in browser is focused) | **Ctrl+R** |

243| Reload browser page without cache (When the built-in browser is focused) | **Ctrl+Shift+R** |

244| Copy browser URL (When the built-in browser is focused) | **Ctrl+Shift+C** |

245| Toggle browser browse or comment mode (When browser commenting is available) | **Ctrl+.** |

246| Copy chat deep link | **Ctrl+Alt+L** |

247| Copy session ID | **Ctrl+Alt+C** |

248| Copy working directory (Codex only) | **Ctrl+Shift+C** |To find, customize, or reset app shortcuts, open **Settings > Keyboard

249Shortcuts**.

250 

35You can search by command name or switch the search field into keystroke mode251You can search by command name or switch the search field into keystroke mode

36and press the shortcut you want to find.252and press the shortcut you want to find. Appshots use a separate global shortcut

253under **Settings > Appshots**.

254 

255On Linux, experimental native Wayland can affect shortcut support. See the

256[Linux desktop app guide](https://learn.chatgpt.com/docs/linux/linux-app#wayland-support).

37 257 

38<a id="search-past-tasks-and-find-in-a-task"></a>258<a id="search-past-tasks-and-find-in-a-task"></a>

39 259 

40## Search past chats and find in a chat260## Search past chats and find in a chat

41 261 

42Use chat search (<kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>G</kbd>) to reopen a past262Use **Search chats** to reopen a past chat. Search chats doesn't have a default

43chat. When expanded matching is available, it can also match chat content and263shortcut. You can assign one under **Settings > Keyboard Shortcuts**. When

44Git branch names, so you can search for a phrase from the chat or a264expanded matching is available, search can also match chat content and Git

45branch such as `fix/login-redirect`.265branch names, so you can search for a phrase from the chat or a branch such as

266`fix/login-redirect`.

46 267 

47Use **Find in chat** (<kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>F</kbd>) after opening268Use **Find in chat** after opening a chat to find text within it. It doesn't

48a chat to find text within it. It doesn't search across other chats.269search across other chats.

49 270 

50For actions that start with `/`, see [Slash commands](https://learn.chatgpt.com/docs/reference/slash-commands).271For actions that start with `/`, see [Slash commands](https://learn.chatgpt.com/docs/reference/slash-commands).

51 272 

Details

6 6 

7## Keyboard shortcuts7## Keyboard shortcuts

8 8 

9| | Action | Shortcut |9Choose your platform to see its default shortcuts. Some shortcuts appear only when the corresponding feature or view is available.

10| ----------- | ------------------- | ---------------------------------------------------------------------------------------------------------------------- |10 

11| **General** | | |11### macOS

12| | Command menu | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> or <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>K</kbd> |12 

13| | Settings | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>,</kbd> |13 

14| | Keyboard shortcuts | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>/</kbd> |14 

15| | Open folder | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>O</kbd> |15| General | Shortcut |

16| | Navigate back | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>[</kbd> |16| --- | --- |

17| | Navigate forward | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>]</kbd> |17| Open command menu | **⌘+⇧+P** or **⌘+K** |

18| | Increase font size | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>+</kbd> |18| Open settings | **⌘+,** |

19| | Decrease font size | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>-</kbd> |19| Open keyboard shortcuts | **⌘+/** |

20| | Toggle sidebar | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>B</kbd> |20| Open folder (Codex and Work only) | **⌘+O** |

21| | Open review tab | <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>G</kbd> |21| Navigate back | **⌘+[** or **Mouse Back** |

22| | Toggle review panel | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>B</kbd> |22| Navigate forward | **⌘+]** or **Mouse Forward** |

23| | Toggle bottom panel | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>J</kbd> |23| Increase font size | **⌘++** or **⌘+Numpad +** |

24| | Toggle terminal | <kbd>Ctrl</kbd> + <kbd>`</kbd> |24| Decrease font size | **⌘+-** or **⌘+Numpad −** |

25| | Clear the terminal | <kbd>Ctrl</kbd> + <kbd>L</kbd> |25| Reset font size | **⌘+0** or **⌘+Numpad 0** |

26| **Chat** | Quick chat | <kbd>Cmd</kbd> + <kbd>Option</kbd> + <kbd>N</kbd> (macOS) or <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>N</kbd> (Windows) |26| Toggle sidebar | **⌘+B** |

27| | New chat | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>N</kbd> or <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>O</kbd> |27| Toggle bottom panel (Codex only) | **⌘+J** |

28| | Search chats | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>G</kbd> |28| Toggle terminal (Codex only) | **⌃+`** |

29| | Find in chat | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>F</kbd> |29| Clear terminal (When the terminal is focused) | **⌃+L** or **⌘+K** |

30| | Previous chat | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>[</kbd> |30| Clear all unread indicators (Codex only) | **⇧+Esc** |

31| | Next chat | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>]</kbd> |31| Undo last app action | **⌘+Z** |

32| **Input** | Dictation | <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>D</kbd> |32| Redo last app action | **⌘+⇧+Z** |

33 33| Close current tab or window | **⌘+W** |

34To find, customize, or reset shortcuts, open **Settings > Keyboard Shortcuts**.34| Toggle full screen | **⌘+⌃+F** |

35| Quit the app | **⌘+Q** |

36 

37| Chats | Shortcut |

38| --- | --- |

39| New chat | **⌘+N** or **⌘+⇧+O** |

40| New standalone chat (Codex only) | **⌘+⌥+O** |

41| Quick chat (ChatGPT only) | **⌘+⌥+N** |

42| New temporary chat (ChatGPT only) | **⌘+⇧+N** |

43| Archive chat | **⌘+⇧+A** |

44| Mark chat as unread | **⌘+⇧+U** |

45| Pin or unpin chat | **⌘+⌥+P** |

46| Rename chat | **⌘+⌥+R** |

47| Open side chat (Codex only) | **⌘+⌥+S** |

48| Search chats (Assign one in Settings > Keyboard Shortcuts) | Not assigned by default |

49| Find in chat | **⌘+F** |

50| Find next match | **⌘+G** |

51| Find previous match | **⌘+⇧+G** |

52| Previous chat or tab | **⌃+⇧+Tab** or **⌘+⇧+[** or **⌘+⌥+←** |

53| Next chat or tab | **⌃+Tab** or **⌘+⇧+]** or **⌘+⌥+→** |

54| Next chat needing attention (Codex only) | **⌘+⌥+A** |

55| Open recent chat 1–6 | **⌘+⌥+1–6** |

56| Go to chat 1–9 | **⌘+1–9** |

57 

58| Input and modes | Shortcut |

59| --- | --- |

60| Open model picker | **⌃+⇧+M** |

61| Open project picker | **⌘+⌥+⇧+O** |

62| Start voice chat (When voice chat is available) | **⌃+⇧+V** |

63| Start dictation (When dictation is available) | **⌃+⇧+D** |

64| Restore previous composer prompt (When the composer is empty) | **↑** |

65| Approve request (When an approval request is open) | **⏎** |

66| Decline request (When an approval request is open) | **Esc** |

67| Switch to Chat, Work, or Codex (In the order shown) | **⌃+1** or **⌃+2** or **⌃+3** |

68| Toggle Activity view (When Activity is available) | **⌘+⌥+U** |

69 

70| Workspace and browser | Shortcut |

71| --- | --- |

72| Run environment action 1 (When the environment defines a primary action) | **⌘+⇧+D** |

73| Search files (Codex only) | **⌘+P** |

74| Toggle file tree (Codex only) | **⌘+⇧+E** |

75| Open review tab (Codex only) | **⌃+⇧+G** |

76| Toggle review panel (Codex only) | **⌘+⌥+B** |

77| Open browser tab (When the built-in browser is available) | **⌘+T** |

78| Toggle browser panel (When the built-in browser is available) | **⌘+⇧+B** |

79| Go to line or focus browser address bar (Depends on the focused view) | **⌘+L** |

80| Browser back (When the built-in browser is focused) | **⌘+←** |

81| Browser forward (When the built-in browser is focused) | **⌘+→** |

82| Reload browser page (When the built-in browser is focused) | **⌘+R** |

83| Reload browser page without cache (When the built-in browser is focused) | **⌘+⇧+R** |

84| Copy browser URL (When the built-in browser is focused) | **⌘+⇧+C** |

85| Toggle browser browse or comment mode (When browser commenting is available) | **⌘+.** |

86| Copy conversation path (Codex only) | **⌘+⌥+⇧+C** |

87| Copy chat deep link | **⌘+⌥+L** |

88| Copy session ID | **⌘+⌥+C** |

89| Copy working directory (Codex only) | **⌘+⇧+C** |

90| Take an Appshot (press both keys simultaneously) | **⌘+⌘** |

91 

92### Windows

93 

94 

95 

96| General | Shortcut |

97| --- | --- |

98| Open command menu | **Ctrl+Shift+P** or **Ctrl+K** |

99| Open settings | **Ctrl+,** |

100| Open keyboard shortcuts | **Ctrl+/** |

101| Open folder (Codex and Work only) | **Ctrl+O** |

102| Navigate back | **Ctrl+[** or **Mouse Back** |

103| Navigate forward | **Ctrl+]** or **Mouse Forward** |

104| Increase font size | **Ctrl++** or **Ctrl+=** or **Ctrl+Numpad +** |

105| Decrease font size | **Ctrl+-** or **Ctrl+Numpad −** |

106| Reset font size | **Ctrl+0** or **Ctrl+Numpad 0** |

107| Toggle sidebar | **Ctrl+B** |

108| Toggle bottom panel (Codex only) | **Ctrl+J** |

109| Toggle terminal (Codex only) | **Ctrl+`** |

110| Clear terminal (When the terminal is focused) | **Ctrl+L** or **Ctrl+K** |

111| Clear all unread indicators (Codex only) | **Shift+Esc** |

112| Undo last app action | **Ctrl+Z** |

113| Redo last app action | **Ctrl+Y** or **Ctrl+Shift+Z** |

114| Close current tab or window | **Ctrl+W** or **Ctrl+F4** |

115| Toggle full screen | **F11** |

116| Quit the app | **Ctrl+Q** |

117 

118| Chats | Shortcut |

119| --- | --- |

120| New chat | **Ctrl+N** or **Ctrl+Shift+O** |

121| New standalone chat (Codex only) | **Ctrl+Alt+O** |

122| Quick chat (ChatGPT only) | **Ctrl+Alt+N** |

123| New temporary chat (ChatGPT only) | **Ctrl+Shift+N** |

124| Archive chat | **Ctrl+Shift+A** |

125| Mark chat as unread | **Ctrl+Shift+U** |

126| Pin or unpin chat | **Ctrl+Alt+P** |

127| Rename chat | **Ctrl+Alt+R** |

128| Open side chat (Codex only) | **Ctrl+Alt+S** |

129| Search chats (Assign one in Settings > Keyboard Shortcuts) | Not assigned by default |

130| Find in chat | **Ctrl+F** |

131| Find next match | **Ctrl+G** |

132| Find previous match | **Shift+F3** |

133| Previous chat or tab | **Ctrl+Shift+Tab** or **Ctrl+Shift+[** or **Ctrl+Page Up** |

134| Next chat or tab | **Ctrl+Tab** or **Ctrl+Shift+]** or **Ctrl+Page Down** |

135| Next chat needing attention (Codex only) | **Ctrl+Alt+A** |

136| Open recent chat 1–6 | **Ctrl+Alt+1–6** |

137| Go to chat 1–9 | **Ctrl+1–9** |

138 

139| Input and modes | Shortcut |

140| --- | --- |

141| Open model picker | **Ctrl+Shift+M** |

142| Open project picker | **Ctrl+Alt+Shift+O** |

143| Start voice chat (When voice chat is available) | **Ctrl+Shift+V** |

144| Start dictation (When dictation is available) | **Ctrl+Shift+D** |

145| Restore previous composer prompt (When the composer is empty) | **↑** |

146| Approve request (When an approval request is open) | **⏎** |

147| Decline request (When an approval request is open) | **Esc** |

148| Switch to Chat, Work, or Codex (In the order shown) | **Alt+1** or **Alt+2** or **Alt+3** |

149| Toggle Activity view (When Activity is available) | **Ctrl+Alt+U** |

150 

151| Workspace and browser | Shortcut |

152| --- | --- |

153| Run environment action 1 (When the environment defines a primary action) | **Win+Shift+D** |

154| Search files (Codex only) | **Ctrl+P** |

155| Toggle file tree (Codex only) | **Ctrl+Shift+E** |

156| Open review tab (Codex only) | **Ctrl+Shift+G** |

157| Toggle review panel (Codex only) | **Ctrl+Alt+B** |

158| Open browser tab (When the built-in browser is available) | **Ctrl+T** |

159| Toggle browser panel (When the built-in browser is available) | **Ctrl+Shift+B** |

160| Go to line or focus browser address bar (Depends on the focused view) | **Ctrl+L** |

161| Browser back (When the built-in browser is focused) | **Alt+←** |

162| Browser forward (When the built-in browser is focused) | **Alt+→** |

163| Reload browser page (When the built-in browser is focused) | **Ctrl+R** |

164| Reload browser page without cache (When the built-in browser is focused) | **Ctrl+Shift+R** |

165| Copy browser URL (When the built-in browser is focused) | **Ctrl+Shift+C** |

166| Toggle browser browse or comment mode (When browser commenting is available) | **Ctrl+.** |

167| Copy chat deep link | **Ctrl+Alt+L** |

168| Copy session ID | **Ctrl+Alt+C** |

169| Copy working directory (Codex only) | **Ctrl+Shift+C** |

170 

171### Linux

172 

173 

174 

175| General | Shortcut |

176| --- | --- |

177| Open command menu | **Ctrl+Shift+P** or **Ctrl+K** |

178| Open settings | **Ctrl+,** |

179| Open keyboard shortcuts | **Ctrl+/** |

180| Open folder (Codex and Work only) | **Ctrl+O** |

181| Navigate back | **Ctrl+[** or **Mouse Back** |

182| Navigate forward | **Ctrl+]** or **Mouse Forward** |

183| Increase font size | **Ctrl++** or **Ctrl+=** or **Ctrl+Numpad +** |

184| Decrease font size | **Ctrl+-** or **Ctrl+Numpad −** |

185| Reset font size | **Ctrl+0** or **Ctrl+Numpad 0** |

186| Toggle sidebar | **Ctrl+B** |

187| Toggle bottom panel (Codex only) | **Ctrl+J** |

188| Toggle terminal (Codex only) | **Ctrl+`** |

189| Clear terminal (When the terminal is focused) | **Ctrl+L** or **Ctrl+K** |

190| Clear all unread indicators (Codex only) | **Shift+Esc** |

191| Undo last app action | **Ctrl+Z** |

192| Redo last app action | **Ctrl+Y** or **Ctrl+Shift+Z** |

193| Close current tab or window | **Ctrl+W** or **Ctrl+F4** |

194| Toggle full screen | **F11** |

195| Quit the app | **Ctrl+Q** |

196 

197| Chats | Shortcut |

198| --- | --- |

199| New chat | **Ctrl+N** or **Ctrl+Shift+O** |

200| New standalone chat (Codex only) | **Ctrl+Alt+O** |

201| Quick chat (ChatGPT only) | **Ctrl+Alt+N** |

202| New temporary chat (ChatGPT only) | **Ctrl+Shift+N** |

203| Archive chat | **Ctrl+Shift+A** |

204| Mark chat as unread | **Ctrl+Shift+U** |

205| Pin or unpin chat | **Ctrl+Alt+P** |

206| Rename chat | **Ctrl+Alt+R** |

207| Open side chat (Codex only) | **Ctrl+Alt+S** |

208| Search chats (Assign one in Settings > Keyboard Shortcuts) | Not assigned by default |

209| Find in chat | **Ctrl+F** |

210| Find next match | **Ctrl+G** |

211| Find previous match | **Shift+F3** |

212| Previous chat or tab | **Ctrl+Shift+Tab** or **Ctrl+Shift+[** or **Ctrl+Page Up** |

213| Next chat or tab | **Ctrl+Tab** or **Ctrl+Shift+]** or **Ctrl+Page Down** |

214| Next chat needing attention (Codex only) | **Ctrl+Alt+A** |

215| Open recent chat 1–6 | **Ctrl+Alt+1–6** |

216| Go to chat 1–9 | **Ctrl+1–9** |

217 

218| Input and modes | Shortcut |

219| --- | --- |

220| Open model picker | **Ctrl+Shift+M** |

221| Open project picker | **Ctrl+Alt+Shift+O** |

222| Start voice chat (When voice chat is available) | **Ctrl+Shift+V** |

223| Start dictation (When dictation is available) | **Ctrl+Shift+D** |

224| Restore previous composer prompt (When the composer is empty) | **↑** |

225| Approve request (When an approval request is open) | **⏎** |

226| Decline request (When an approval request is open) | **Esc** |

227| Switch to Chat, Work, or Codex (In the order shown) | **Alt+1** or **Alt+2** or **Alt+3** |

228| Toggle Activity view (When Activity is available) | **Ctrl+Alt+U** |

229 

230| Workspace and browser | Shortcut |

231| --- | --- |

232| Run environment action 1 (When the environment defines a primary action) | **Super+Shift+D** |

233| Search files (Codex only) | **Ctrl+P** |

234| Toggle file tree (Codex only) | **Ctrl+Shift+E** |

235| Open review tab (Codex only) | **Ctrl+Shift+G** |

236| Toggle review panel (Codex only) | **Ctrl+Alt+B** |

237| Open browser tab (When the built-in browser is available) | **Ctrl+T** |

238| Toggle browser panel (When the built-in browser is available) | **Ctrl+Shift+B** |

239| Go to line or focus browser address bar (Depends on the focused view) | **Ctrl+L** |

240| Browser back (When the built-in browser is focused) | **Alt+←** |

241| Browser forward (When the built-in browser is focused) | **Alt+→** |

242| Reload browser page (When the built-in browser is focused) | **Ctrl+R** |

243| Reload browser page without cache (When the built-in browser is focused) | **Ctrl+Shift+R** |

244| Copy browser URL (When the built-in browser is focused) | **Ctrl+Shift+C** |

245| Toggle browser browse or comment mode (When browser commenting is available) | **Ctrl+.** |

246| Copy chat deep link | **Ctrl+Alt+L** |

247| Copy session ID | **Ctrl+Alt+C** |

248| Copy working directory (Codex only) | **Ctrl+Shift+C** |To find, customize, or reset app shortcuts, open **Settings > Keyboard

249Shortcuts**.

250 

35You can search by command name or switch the search field into keystroke mode251You can search by command name or switch the search field into keystroke mode

36and press the shortcut you want to find.252and press the shortcut you want to find. Appshots use a separate global shortcut

253under **Settings > Appshots**.

254 

255On Linux, experimental native Wayland can affect shortcut support. See the

256[Linux desktop app guide](https://learn.chatgpt.com/docs/linux/linux-app#wayland-support).

37 257 

38<a id="search-past-tasks-and-find-in-a-task"></a>258<a id="search-past-tasks-and-find-in-a-task"></a>

39 259 

40## Search past chats and find in a chat260## Search past chats and find in a chat

41 261 

42Use chat search (<kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>G</kbd>) to reopen a past262Use **Search chats** to reopen a past chat. Search chats doesn't have a default

43chat. When expanded matching is available, it can also match chat content and263shortcut. You can assign one under **Settings > Keyboard Shortcuts**. When

44Git branch names, so you can search for a phrase from the chat or a264expanded matching is available, search can also match chat content and Git

45branch such as `fix/login-redirect`.265branch names, so you can search for a phrase from the chat or a branch such as

266`fix/login-redirect`.

46 267 

47Use **Find in chat** (<kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>F</kbd>) after opening268Use **Find in chat** after opening a chat to find text within it. It doesn't

48a chat to find text within it. It doesn't search across other chats.269search across other chats.

49 270 

50For actions that start with `/`, see [Slash commands](https://learn.chatgpt.com/docs/reference/slash-commands).271For actions that start with `/`, see [Slash commands](https://learn.chatgpt.com/docs/reference/slash-commands).

51 272 

Details

9Enabling agent internet access increases security risk, including:9Enabling agent internet access increases security risk, including:

10 10 

11- Prompt injection from untrusted web content11- Prompt injection from untrusted web content

12- Exfiltration of code or secrets12- Code or secret exfiltration

13- Downloading malware or vulnerable dependencies13- Downloading malware or vulnerable dependencies

14- Pulling in content with license restrictions14- Pulling in content with license restrictions

15 15 


35 35 

36If the agent follows those instructions, it could leak the last commit message to an attacker-controlled server:36If the agent follows those instructions, it could leak the last commit message to an attacker-controlled server:

37 37 

38![Prompt injection leak example](https://cdn.openai.com/API/docs/codex/prompt-injection-example.png)38 

39

40 

41> Illustration: Prompt injection leak example

42 

43 

44 

39 45 

40This example shows how prompt injection can expose sensitive data or lead to unsafe changes. Point Codex only to trusted resources and keep internet access as limited as possible.46This example shows how prompt injection can expose sensitive data or lead to unsafe changes. Point Codex only to trusted resources and keep internet access as limited as possible.

41 47 


62 68 

63## Preset domain lists69## Preset domain lists

64 70 

65Finding the right domains can take some trial and error. Presets help you start with a known-good list, then narrow it down as needed.71Finding the right domains can require iterative testing. Presets help you start with a known-good list, then narrow it down as needed.

66 72 

67### Common dependencies73### Common dependencies

68 74 

Details

188 188 

189 189 

190 190 

191 <img src="https://developers.openai.com/images/codex/ide/approval_mode.png"191

192 alt="Codex approval mode selector in the IDE extension"192

193 class="block h-auto w-full mx-0!"193 

194 />194> Illustration: Codex approval mode selector in the IDE extension

195 

196 

197

195 198 

196 199 

197 200 

Details

242- Ask Codex directly to steer a running subagent, stop it, or close completed242- Ask Codex directly to steer a running subagent, stop it, or close completed

243 subagent threads.243 subagent threads.

244 244 

245<Illustration description="Codex desktop chat showing two subagents working in parallel.">245 

246 <SubagentWorkflowIllustration ariaLabel="Codex desktop chat showing two subagents working in parallel." />246 

247</Illustration>247> Illustration: Codex desktop chat showing two subagents working in parallel.

248 248 

249<Illustration description="Codex desktop Subagents panel with no active subagents and three completed audits.">249 

250 <SubagentWorkflowIllustration250 

251 ariaLabel="Codex desktop Subagents panel with no active subagents and three completed audits."251 

252 class="mt-4"252 

253 variant="results"253> Illustration: Codex desktop Subagents panel with no active subagents and three completed audits.

254 />254 

255</Illustration>255 

256 256 

257</ContentModeSwitch>257</ContentModeSwitch>

258 258 

Details

27your history or record audio, and private-mode web browsing activity is never27your history or record audio, and private-mode web browsing activity is never

28included.28included.

29 29 

30<Illustration description="Computer History timeline showing activity summaries, contributing apps, and suggested skills and automations">30 

31 <ComputerHistoryTimelineIllustration />31 

32</Illustration>32> Illustration: Computer History timeline showing activity summaries, contributing apps, and suggested skills and automations

33 

34 

33 35 

34## How Computer History helps36## How Computer History helps

35 37 

Details

53For the relationship between these controls, see53For the relationship between these controls, see

54[Roles and workspace permissions](https://learn.chatgpt.com/docs/enterprise/roles-and-workspace-permissions).54[Roles and workspace permissions](https://learn.chatgpt.com/docs/enterprise/roles-and-workspace-permissions).

55 55 

56<CodexScreenshot56 

57 alt="Access token access permission in ChatGPT workspace RBAC settings"57

58 lightSrc="/images/codex/enterprise/rbac_access_token_access_permission.png"58 

59 darkSrc="/images/codex/enterprise/rbac_access_token_access_permission_dark.png"59> Illustration: Access token access permission in ChatGPT workspace RBAC settings

60 maxWidth={847}60 

61 variant="no-wallpaper"61 

62/>62 

63 63 

641. Go to [Workspace Settings > Permissions & roles](https://chatgpt.com/admin/settings).641. Go to [Workspace Settings > Permissions & roles](https://chatgpt.com/admin/settings).

652. In the **Access tokens** section, turn on **Allow users to create access tokens** if all allowed members should be able to create access tokens.652. In the **Access tokens** section, turn on **Allow users to create access tokens** if all allowed members should be able to create access tokens.


71 71 

72Workspace owners and admins can set the longest expiration that members can choose when they create a Codex access token. Go to [Workspace Settings > Permissions & roles](https://chatgpt.com/admin/settings), then set **Access token expiration limit** in the **Codex Local** section.72Workspace owners and admins can set the longest expiration that members can choose when they create a Codex access token. Go to [Workspace Settings > Permissions & roles](https://chatgpt.com/admin/settings), then set **Access token expiration limit** in the **Codex Local** section.

73 73 

74<CodexScreenshot74 

75 alt="Access token expiration limit in ChatGPT workspace permissions settings"75

76 lightSrc="/images/codex/enterprise/access_token_expiration_limit.png"76 

77 darkSrc="/images/codex/enterprise/access_token_expiration_limit_dark.png"77> Illustration: Access token expiration limit in ChatGPT workspace permissions settings

78 maxWidth={847}78 

79 variant="no-wallpaper"79 

80/>80 

81 81 

82The limit applies to new access tokens. Existing tokens keep their current expiration.82The limit applies to new access tokens. Existing tokens keep their current expiration.

83 83 


881. Go to [Access tokens](https://chatgpt.com/admin/access-tokens).881. Go to [Access tokens](https://chatgpt.com/admin/access-tokens).

892. Select **Create**.892. Select **Create**.

90 90 

91<CodexScreenshot91 

92 alt="Access tokens page with the Create button"92

93 lightSrc="/images/codex/enterprise/access_token_create_header.png"93 

94 darkSrc="/images/codex/enterprise/access_token_create_header_dark.png"94> Illustration: Access tokens page with the Create button

95 maxWidth={942}95 

96 variant="no-wallpaper"96 

97/>97 

98 98 

993. Enter a descriptive name, such as `release-ci` or `nightly-docs-check`.993. Enter a descriptive name, such as `release-ci` or `nightly-docs-check`.

100 100 

101<CodexScreenshot101 

102 alt="Create access token modal with fields for name and expiration"102

103 lightSrc="/images/codex/enterprise/access_token_creation_modal.png"103 

104 darkSrc="/images/codex/enterprise/access_token_creation_modal_dark.png"104> Illustration: Create access token modal with fields for name and expiration

105 maxWidth={544}105 

106 variant="no-wallpaper"106 

107/>107 

108 108 

1094. Choose an expiration. Prefer a finite expiration such as 7, 30, 60, or 90 days. If you choose **No expiration**, rotate the token on a regular schedule.1094. Choose an expiration. Prefer a finite expiration such as 7, 30, 60, or 90 days. If you choose **No expiration**, rotate the token on a regular schedule.

1105. Select **Create**.1105. Select **Create**.

Details

13 13 

14For the full glossary and concepts, explore the [concepts section](https://learn.chatgpt.com/docs/prompting).14For the full glossary and concepts, explore the [concepts section](https://learn.chatgpt.com/docs/prompting).

15 15 

16<CodexScreenshot16 

17 alt="New chat composer with Local, Worktree, and Cloud environment options"17

18 lightSrc="/images/codex/app/modes-light.webp"18 

19 darkSrc="/images/codex/app/modes-dark.webp"19> Illustration: New chat composer with Local, Worktree, and Cloud environment options

20 maxHeight="400px"

21 class="my-8"

22/>

Details

11 11 

12 12

13 13 

14 <Illustration description="Interactive Codex Micro keyboard with illuminated Agent Keys, customizable Command Keys, a dial, and an analog stick">14

15 <CodexMicroKeyboardIllustration15 

16 ariaLabel="Interactive Codex Micro keyboard with illuminated Agent Keys, customizable Command Keys, a dial, and an analog stick"16> Illustration: Interactive Codex Micro keyboard with illuminated Agent Keys, customizable Command Keys, a dial, and an analog stick

17 />17 

18 </Illustration>18 

19 19

20 20 

21 21 

Details

14your phone with a desktop host. Availability also depends on rollout status and14your phone with a desktop host. Availability also depends on rollout status and

15workspace settings. See [feature availability](https://learn.chatgpt.com/docs/pricing#feature-availability).15workspace settings. See [feature availability](https://learn.chatgpt.com/docs/pricing#feature-availability).

16 16 

17<Illustration description="Interactive ChatGPT Voice conversation with microphone and speaker controls.">17 

18 <CodexVoiceAgentIllustration />18 

19</Illustration>19> Illustration: Interactive ChatGPT Voice conversation with microphone and speaker controls.

20 

21 

20 22 

21## Start talking23## Start talking

22 24 

Details

53Use ChatGPT Work to turn notes, docs, research, or meeting materials into a structured53Use ChatGPT Work to turn notes, docs, research, or meeting materials into a structured

54deck.54deck.

55 55 

56<CodexScreenshot56 

57 alt="A presentation created in ChatGPT Work"57

58 lightSrc="/codex/get-started-with-work/create-presentation.webp"58 

59 darkSrc="/codex/get-started-with-work/create-presentation.webp"59> Illustration: A presentation created in ChatGPT Work

60 maxHeight={520}60 

61 class="my-6 p-4 md:p-8"61 

62/>62 

63 63 

64 64 

65 65 


74Use ChatGPT Work to turn notes, files, or research into a spreadsheet that compares74Use ChatGPT Work to turn notes, files, or research into a spreadsheet that compares

75options and helps you make a decision.75options and helps you make a decision.

76 76 

77<CodexScreenshot77 

78 alt="A comparison spreadsheet created in ChatGPT Work"78

79 lightSrc="/codex/get-started-with-work/comparison-spreadsheet.webp"79 

80 darkSrc="/codex/get-started-with-work/comparison-spreadsheet.webp"80> Illustration: A comparison spreadsheet created in ChatGPT Work

81 maxHeight={520}81 

82 class="my-6 p-4 md:p-8"82 

83/>83 

84 84 

85 85 

86 86 


95Use scheduled tasks when you want ChatGPT Work to repeat, monitor, or refresh something95Use scheduled tasks when you want ChatGPT Work to repeat, monitor, or refresh something

96over time.96over time.

97 97 

98<CodexScreenshot98 

99 alt="A recurring update scheduled in ChatGPT Work"99

100 lightSrc="/codex/get-started-with-work/recurring-update.webp"100 

101 darkSrc="/codex/get-started-with-work/recurring-update.webp"101> Illustration: A recurring update scheduled in ChatGPT Work

102 maxHeight={520}102 

103 class="my-6 p-4 md:p-8"103 

104/>104 

105 105 

106 106 

107 107 


144 144 

145## Add plugins for more context and better outputs145## Add plugins for more context and better outputs

146 146 

147<CodexScreenshot147 

148 alt="The plugins library in ChatGPT Work"148

149 lightSrc="/codex/get-started-with-work/plugins.webp"149 

150 darkSrc="/codex/get-started-with-work/plugins.webp"150> Illustration: The plugins library in ChatGPT Work

151 maxHeight={520}151 

152 class="my-6 p-4 md:p-8"152 

153/>153 

154 154 

155Plugins connect ChatGPT Work to tools your team uses, like Slack, Google Drive,155Plugins connect ChatGPT Work to tools your team uses, like Slack, Google Drive,

156SharePoint, email, calendars, customer relationship management systems, and156SharePoint, email, calendars, customer relationship management systems, and

ide/commands.md +254 −33

Details

6 6 

7## Keyboard shortcuts7## Keyboard shortcuts

8 8 

9| | Action | Shortcut |9Choose your platform to see its default shortcuts. Some shortcuts appear only when the corresponding feature or view is available.

10| ----------- | ------------------- | ---------------------------------------------------------------------------------------------------------------------- |10 

11| **General** | | |11### macOS

12| | Command menu | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> or <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>K</kbd> |12 

13| | Settings | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>,</kbd> |13 

14| | Keyboard shortcuts | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>/</kbd> |14 

15| | Open folder | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>O</kbd> |15| General | Shortcut |

16| | Navigate back | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>[</kbd> |16| --- | --- |

17| | Navigate forward | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>]</kbd> |17| Open command menu | **⌘+⇧+P** or **⌘+K** |

18| | Increase font size | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>+</kbd> |18| Open settings | **⌘+,** |

19| | Decrease font size | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>-</kbd> |19| Open keyboard shortcuts | **⌘+/** |

20| | Toggle sidebar | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>B</kbd> |20| Open folder (Codex and Work only) | **⌘+O** |

21| | Open review tab | <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>G</kbd> |21| Navigate back | **⌘+[** or **Mouse Back** |

22| | Toggle review panel | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>B</kbd> |22| Navigate forward | **⌘+]** or **Mouse Forward** |

23| | Toggle bottom panel | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>J</kbd> |23| Increase font size | **⌘++** or **⌘+Numpad +** |

24| | Toggle terminal | <kbd>Ctrl</kbd> + <kbd>`</kbd> |24| Decrease font size | **⌘+-** or **⌘+Numpad −** |

25| | Clear the terminal | <kbd>Ctrl</kbd> + <kbd>L</kbd> |25| Reset font size | **⌘+0** or **⌘+Numpad 0** |

26| **Chat** | Quick chat | <kbd>Cmd</kbd> + <kbd>Option</kbd> + <kbd>N</kbd> (macOS) or <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>N</kbd> (Windows) |26| Toggle sidebar | **⌘+B** |

27| | New chat | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>N</kbd> or <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>O</kbd> |27| Toggle bottom panel (Codex only) | **⌘+J** |

28| | Search chats | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>G</kbd> |28| Toggle terminal (Codex only) | **⌃+`** |

29| | Find in chat | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>F</kbd> |29| Clear terminal (When the terminal is focused) | **⌃+L** or **⌘+K** |

30| | Previous chat | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>[</kbd> |30| Clear all unread indicators (Codex only) | **⇧+Esc** |

31| | Next chat | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>]</kbd> |31| Undo last app action | **⌘+Z** |

32| **Input** | Dictation | <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>D</kbd> |32| Redo last app action | **⌘+⇧+Z** |

33 33| Close current tab or window | **⌘+W** |

34To find, customize, or reset shortcuts, open **Settings > Keyboard Shortcuts**.34| Toggle full screen | **⌘+⌃+F** |

35| Quit the app | **⌘+Q** |

36 

37| Chats | Shortcut |

38| --- | --- |

39| New chat | **⌘+N** or **⌘+⇧+O** |

40| New standalone chat (Codex only) | **⌘+⌥+O** |

41| Quick chat (ChatGPT only) | **⌘+⌥+N** |

42| New temporary chat (ChatGPT only) | **⌘+⇧+N** |

43| Archive chat | **⌘+⇧+A** |

44| Mark chat as unread | **⌘+⇧+U** |

45| Pin or unpin chat | **⌘+⌥+P** |

46| Rename chat | **⌘+⌥+R** |

47| Open side chat (Codex only) | **⌘+⌥+S** |

48| Search chats (Assign one in Settings > Keyboard Shortcuts) | Not assigned by default |

49| Find in chat | **⌘+F** |

50| Find next match | **⌘+G** |

51| Find previous match | **⌘+⇧+G** |

52| Previous chat or tab | **⌃+⇧+Tab** or **⌘+⇧+[** or **⌘+⌥+←** |

53| Next chat or tab | **⌃+Tab** or **⌘+⇧+]** or **⌘+⌥+→** |

54| Next chat needing attention (Codex only) | **⌘+⌥+A** |

55| Open recent chat 1–6 | **⌘+⌥+1–6** |

56| Go to chat 1–9 | **⌘+1–9** |

57 

58| Input and modes | Shortcut |

59| --- | --- |

60| Open model picker | **⌃+⇧+M** |

61| Open project picker | **⌘+⌥+⇧+O** |

62| Start voice chat (When voice chat is available) | **⌃+⇧+V** |

63| Start dictation (When dictation is available) | **⌃+⇧+D** |

64| Restore previous composer prompt (When the composer is empty) | **↑** |

65| Approve request (When an approval request is open) | **⏎** |

66| Decline request (When an approval request is open) | **Esc** |

67| Switch to Chat, Work, or Codex (In the order shown) | **⌃+1** or **⌃+2** or **⌃+3** |

68| Toggle Activity view (When Activity is available) | **⌘+⌥+U** |

69 

70| Workspace and browser | Shortcut |

71| --- | --- |

72| Run environment action 1 (When the environment defines a primary action) | **⌘+⇧+D** |

73| Search files (Codex only) | **⌘+P** |

74| Toggle file tree (Codex only) | **⌘+⇧+E** |

75| Open review tab (Codex only) | **⌃+⇧+G** |

76| Toggle review panel (Codex only) | **⌘+⌥+B** |

77| Open browser tab (When the built-in browser is available) | **⌘+T** |

78| Toggle browser panel (When the built-in browser is available) | **⌘+⇧+B** |

79| Go to line or focus browser address bar (Depends on the focused view) | **⌘+L** |

80| Browser back (When the built-in browser is focused) | **⌘+←** |

81| Browser forward (When the built-in browser is focused) | **⌘+→** |

82| Reload browser page (When the built-in browser is focused) | **⌘+R** |

83| Reload browser page without cache (When the built-in browser is focused) | **⌘+⇧+R** |

84| Copy browser URL (When the built-in browser is focused) | **⌘+⇧+C** |

85| Toggle browser browse or comment mode (When browser commenting is available) | **⌘+.** |

86| Copy conversation path (Codex only) | **⌘+⌥+⇧+C** |

87| Copy chat deep link | **⌘+⌥+L** |

88| Copy session ID | **⌘+⌥+C** |

89| Copy working directory (Codex only) | **⌘+⇧+C** |

90| Take an Appshot (press both keys simultaneously) | **⌘+⌘** |

91 

92### Windows

93 

94 

95 

96| General | Shortcut |

97| --- | --- |

98| Open command menu | **Ctrl+Shift+P** or **Ctrl+K** |

99| Open settings | **Ctrl+,** |

100| Open keyboard shortcuts | **Ctrl+/** |

101| Open folder (Codex and Work only) | **Ctrl+O** |

102| Navigate back | **Ctrl+[** or **Mouse Back** |

103| Navigate forward | **Ctrl+]** or **Mouse Forward** |

104| Increase font size | **Ctrl++** or **Ctrl+=** or **Ctrl+Numpad +** |

105| Decrease font size | **Ctrl+-** or **Ctrl+Numpad −** |

106| Reset font size | **Ctrl+0** or **Ctrl+Numpad 0** |

107| Toggle sidebar | **Ctrl+B** |

108| Toggle bottom panel (Codex only) | **Ctrl+J** |

109| Toggle terminal (Codex only) | **Ctrl+`** |

110| Clear terminal (When the terminal is focused) | **Ctrl+L** or **Ctrl+K** |

111| Clear all unread indicators (Codex only) | **Shift+Esc** |

112| Undo last app action | **Ctrl+Z** |

113| Redo last app action | **Ctrl+Y** or **Ctrl+Shift+Z** |

114| Close current tab or window | **Ctrl+W** or **Ctrl+F4** |

115| Toggle full screen | **F11** |

116| Quit the app | **Ctrl+Q** |

117 

118| Chats | Shortcut |

119| --- | --- |

120| New chat | **Ctrl+N** or **Ctrl+Shift+O** |

121| New standalone chat (Codex only) | **Ctrl+Alt+O** |

122| Quick chat (ChatGPT only) | **Ctrl+Alt+N** |

123| New temporary chat (ChatGPT only) | **Ctrl+Shift+N** |

124| Archive chat | **Ctrl+Shift+A** |

125| Mark chat as unread | **Ctrl+Shift+U** |

126| Pin or unpin chat | **Ctrl+Alt+P** |

127| Rename chat | **Ctrl+Alt+R** |

128| Open side chat (Codex only) | **Ctrl+Alt+S** |

129| Search chats (Assign one in Settings > Keyboard Shortcuts) | Not assigned by default |

130| Find in chat | **Ctrl+F** |

131| Find next match | **Ctrl+G** |

132| Find previous match | **Shift+F3** |

133| Previous chat or tab | **Ctrl+Shift+Tab** or **Ctrl+Shift+[** or **Ctrl+Page Up** |

134| Next chat or tab | **Ctrl+Tab** or **Ctrl+Shift+]** or **Ctrl+Page Down** |

135| Next chat needing attention (Codex only) | **Ctrl+Alt+A** |

136| Open recent chat 1–6 | **Ctrl+Alt+1–6** |

137| Go to chat 1–9 | **Ctrl+1–9** |

138 

139| Input and modes | Shortcut |

140| --- | --- |

141| Open model picker | **Ctrl+Shift+M** |

142| Open project picker | **Ctrl+Alt+Shift+O** |

143| Start voice chat (When voice chat is available) | **Ctrl+Shift+V** |

144| Start dictation (When dictation is available) | **Ctrl+Shift+D** |

145| Restore previous composer prompt (When the composer is empty) | **↑** |

146| Approve request (When an approval request is open) | **⏎** |

147| Decline request (When an approval request is open) | **Esc** |

148| Switch to Chat, Work, or Codex (In the order shown) | **Alt+1** or **Alt+2** or **Alt+3** |

149| Toggle Activity view (When Activity is available) | **Ctrl+Alt+U** |

150 

151| Workspace and browser | Shortcut |

152| --- | --- |

153| Run environment action 1 (When the environment defines a primary action) | **Win+Shift+D** |

154| Search files (Codex only) | **Ctrl+P** |

155| Toggle file tree (Codex only) | **Ctrl+Shift+E** |

156| Open review tab (Codex only) | **Ctrl+Shift+G** |

157| Toggle review panel (Codex only) | **Ctrl+Alt+B** |

158| Open browser tab (When the built-in browser is available) | **Ctrl+T** |

159| Toggle browser panel (When the built-in browser is available) | **Ctrl+Shift+B** |

160| Go to line or focus browser address bar (Depends on the focused view) | **Ctrl+L** |

161| Browser back (When the built-in browser is focused) | **Alt+←** |

162| Browser forward (When the built-in browser is focused) | **Alt+→** |

163| Reload browser page (When the built-in browser is focused) | **Ctrl+R** |

164| Reload browser page without cache (When the built-in browser is focused) | **Ctrl+Shift+R** |

165| Copy browser URL (When the built-in browser is focused) | **Ctrl+Shift+C** |

166| Toggle browser browse or comment mode (When browser commenting is available) | **Ctrl+.** |

167| Copy chat deep link | **Ctrl+Alt+L** |

168| Copy session ID | **Ctrl+Alt+C** |

169| Copy working directory (Codex only) | **Ctrl+Shift+C** |

170 

171### Linux

172 

173 

174 

175| General | Shortcut |

176| --- | --- |

177| Open command menu | **Ctrl+Shift+P** or **Ctrl+K** |

178| Open settings | **Ctrl+,** |

179| Open keyboard shortcuts | **Ctrl+/** |

180| Open folder (Codex and Work only) | **Ctrl+O** |

181| Navigate back | **Ctrl+[** or **Mouse Back** |

182| Navigate forward | **Ctrl+]** or **Mouse Forward** |

183| Increase font size | **Ctrl++** or **Ctrl+=** or **Ctrl+Numpad +** |

184| Decrease font size | **Ctrl+-** or **Ctrl+Numpad −** |

185| Reset font size | **Ctrl+0** or **Ctrl+Numpad 0** |

186| Toggle sidebar | **Ctrl+B** |

187| Toggle bottom panel (Codex only) | **Ctrl+J** |

188| Toggle terminal (Codex only) | **Ctrl+`** |

189| Clear terminal (When the terminal is focused) | **Ctrl+L** or **Ctrl+K** |

190| Clear all unread indicators (Codex only) | **Shift+Esc** |

191| Undo last app action | **Ctrl+Z** |

192| Redo last app action | **Ctrl+Y** or **Ctrl+Shift+Z** |

193| Close current tab or window | **Ctrl+W** or **Ctrl+F4** |

194| Toggle full screen | **F11** |

195| Quit the app | **Ctrl+Q** |

196 

197| Chats | Shortcut |

198| --- | --- |

199| New chat | **Ctrl+N** or **Ctrl+Shift+O** |

200| New standalone chat (Codex only) | **Ctrl+Alt+O** |

201| Quick chat (ChatGPT only) | **Ctrl+Alt+N** |

202| New temporary chat (ChatGPT only) | **Ctrl+Shift+N** |

203| Archive chat | **Ctrl+Shift+A** |

204| Mark chat as unread | **Ctrl+Shift+U** |

205| Pin or unpin chat | **Ctrl+Alt+P** |

206| Rename chat | **Ctrl+Alt+R** |

207| Open side chat (Codex only) | **Ctrl+Alt+S** |

208| Search chats (Assign one in Settings > Keyboard Shortcuts) | Not assigned by default |

209| Find in chat | **Ctrl+F** |

210| Find next match | **Ctrl+G** |

211| Find previous match | **Shift+F3** |

212| Previous chat or tab | **Ctrl+Shift+Tab** or **Ctrl+Shift+[** or **Ctrl+Page Up** |

213| Next chat or tab | **Ctrl+Tab** or **Ctrl+Shift+]** or **Ctrl+Page Down** |

214| Next chat needing attention (Codex only) | **Ctrl+Alt+A** |

215| Open recent chat 1–6 | **Ctrl+Alt+1–6** |

216| Go to chat 1–9 | **Ctrl+1–9** |

217 

218| Input and modes | Shortcut |

219| --- | --- |

220| Open model picker | **Ctrl+Shift+M** |

221| Open project picker | **Ctrl+Alt+Shift+O** |

222| Start voice chat (When voice chat is available) | **Ctrl+Shift+V** |

223| Start dictation (When dictation is available) | **Ctrl+Shift+D** |

224| Restore previous composer prompt (When the composer is empty) | **↑** |

225| Approve request (When an approval request is open) | **⏎** |

226| Decline request (When an approval request is open) | **Esc** |

227| Switch to Chat, Work, or Codex (In the order shown) | **Alt+1** or **Alt+2** or **Alt+3** |

228| Toggle Activity view (When Activity is available) | **Ctrl+Alt+U** |

229 

230| Workspace and browser | Shortcut |

231| --- | --- |

232| Run environment action 1 (When the environment defines a primary action) | **Super+Shift+D** |

233| Search files (Codex only) | **Ctrl+P** |

234| Toggle file tree (Codex only) | **Ctrl+Shift+E** |

235| Open review tab (Codex only) | **Ctrl+Shift+G** |

236| Toggle review panel (Codex only) | **Ctrl+Alt+B** |

237| Open browser tab (When the built-in browser is available) | **Ctrl+T** |

238| Toggle browser panel (When the built-in browser is available) | **Ctrl+Shift+B** |

239| Go to line or focus browser address bar (Depends on the focused view) | **Ctrl+L** |

240| Browser back (When the built-in browser is focused) | **Alt+←** |

241| Browser forward (When the built-in browser is focused) | **Alt+→** |

242| Reload browser page (When the built-in browser is focused) | **Ctrl+R** |

243| Reload browser page without cache (When the built-in browser is focused) | **Ctrl+Shift+R** |

244| Copy browser URL (When the built-in browser is focused) | **Ctrl+Shift+C** |

245| Toggle browser browse or comment mode (When browser commenting is available) | **Ctrl+.** |

246| Copy chat deep link | **Ctrl+Alt+L** |

247| Copy session ID | **Ctrl+Alt+C** |

248| Copy working directory (Codex only) | **Ctrl+Shift+C** |To find, customize, or reset app shortcuts, open **Settings > Keyboard

249Shortcuts**.

250 

35You can search by command name or switch the search field into keystroke mode251You can search by command name or switch the search field into keystroke mode

36and press the shortcut you want to find.252and press the shortcut you want to find. Appshots use a separate global shortcut

253under **Settings > Appshots**.

254 

255On Linux, experimental native Wayland can affect shortcut support. See the

256[Linux desktop app guide](https://learn.chatgpt.com/docs/linux/linux-app#wayland-support).

37 257 

38<a id="search-past-tasks-and-find-in-a-task"></a>258<a id="search-past-tasks-and-find-in-a-task"></a>

39 259 

40## Search past chats and find in a chat260## Search past chats and find in a chat

41 261 

42Use chat search (<kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>G</kbd>) to reopen a past262Use **Search chats** to reopen a past chat. Search chats doesn't have a default

43chat. When expanded matching is available, it can also match chat content and263shortcut. You can assign one under **Settings > Keyboard Shortcuts**. When

44Git branch names, so you can search for a phrase from the chat or a264expanded matching is available, search can also match chat content and Git

45branch such as `fix/login-redirect`.265branch names, so you can search for a phrase from the chat or a branch such as

266`fix/login-redirect`.

46 267 

47Use **Find in chat** (<kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>F</kbd>) after opening268Use **Find in chat** after opening a chat to find text within it. It doesn't

48a chat to find text within it. It doesn't search across other chats.269search across other chats.

49 270 

50For actions that start with `/`, see [Slash commands](https://learn.chatgpt.com/docs/reference/slash-commands).271For actions that start with `/`, see [Slash commands](https://learn.chatgpt.com/docs/reference/slash-commands).

51 272 

ide/settings.md +11 −14

Details

46adjusting accent, background, and foreground colors, and changing the UI and46adjusting accent, background, and foreground colors, and changing the UI and

47code fonts. You can also share your custom theme with friends.47code fonts. You can also share your custom theme with friends.

48 48 

49<CodexScreenshot49 

50 alt="ChatGPT desktop app Appearance settings showing theme selection, color controls, and font options"50

51 lightSrc="/images/codex/app/theme-selection-light.webp"51 

52 darkSrc="/images/codex/app/theme-selection-dark.webp"52> Illustration: ChatGPT desktop app Appearance settings showing theme selection, color controls, and font options

53 maxHeight="720px"53 

54 class="mb-8"54 

55/>55 

56 56 

57## Pets57## Pets

58 58 


128next to your browser, editor, or design preview. Turn on **Always on top** when128next to your browser, editor, or design preview. Turn on **Always on top** when

129you want the chat to remain visible while you work in another app.129you want the chat to remain visible while you work in another app.

130 130 

131<CodexScreenshot131 

132 alt="ChatGPT desktop app chat displayed in a floating pop-out window"132

133 lightSrc="/images/codex/app/popover-light.webp"133 

134 darkSrc="/images/codex/app/popover-dark.webp"134> Illustration: ChatGPT desktop app chat displayed in a floating pop-out window

135 maxHeight="400px"

136 class="my-8"

137/>

Details

6 6 

7## Keyboard shortcuts7## Keyboard shortcuts

8 8 

9| | Action | Shortcut |9Choose your platform to see its default shortcuts. Some shortcuts appear only when the corresponding feature or view is available.

10| ----------- | ------------------- | ---------------------------------------------------------------------------------------------------------------------- |10 

11| **General** | | |11### macOS

12| | Command menu | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> or <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>K</kbd> |12 

13| | Settings | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>,</kbd> |13 

14| | Keyboard shortcuts | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>/</kbd> |14 

15| | Open folder | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>O</kbd> |15| General | Shortcut |

16| | Navigate back | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>[</kbd> |16| --- | --- |

17| | Navigate forward | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>]</kbd> |17| Open command menu | **⌘+⇧+P** or **⌘+K** |

18| | Increase font size | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>+</kbd> |18| Open settings | **⌘+,** |

19| | Decrease font size | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>-</kbd> |19| Open keyboard shortcuts | **⌘+/** |

20| | Toggle sidebar | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>B</kbd> |20| Open folder (Codex and Work only) | **⌘+O** |

21| | Open review tab | <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>G</kbd> |21| Navigate back | **⌘+[** or **Mouse Back** |

22| | Toggle review panel | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>B</kbd> |22| Navigate forward | **⌘+]** or **Mouse Forward** |

23| | Toggle bottom panel | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>J</kbd> |23| Increase font size | **⌘++** or **⌘+Numpad +** |

24| | Toggle terminal | <kbd>Ctrl</kbd> + <kbd>`</kbd> |24| Decrease font size | **⌘+-** or **⌘+Numpad −** |

25| | Clear the terminal | <kbd>Ctrl</kbd> + <kbd>L</kbd> |25| Reset font size | **⌘+0** or **⌘+Numpad 0** |

26| **Chat** | Quick chat | <kbd>Cmd</kbd> + <kbd>Option</kbd> + <kbd>N</kbd> (macOS) or <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>N</kbd> (Windows) |26| Toggle sidebar | **⌘+B** |

27| | New chat | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>N</kbd> or <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>O</kbd> |27| Toggle bottom panel (Codex only) | **⌘+J** |

28| | Search chats | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>G</kbd> |28| Toggle terminal (Codex only) | **⌃+`** |

29| | Find in chat | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>F</kbd> |29| Clear terminal (When the terminal is focused) | **⌃+L** or **⌘+K** |

30| | Previous chat | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>[</kbd> |30| Clear all unread indicators (Codex only) | **⇧+Esc** |

31| | Next chat | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>]</kbd> |31| Undo last app action | **⌘+Z** |

32| **Input** | Dictation | <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>D</kbd> |32| Redo last app action | **⌘+⇧+Z** |

33 33| Close current tab or window | **⌘+W** |

34To find, customize, or reset shortcuts, open **Settings > Keyboard Shortcuts**.34| Toggle full screen | **⌘+⌃+F** |

35| Quit the app | **⌘+Q** |

36 

37| Chats | Shortcut |

38| --- | --- |

39| New chat | **⌘+N** or **⌘+⇧+O** |

40| New standalone chat (Codex only) | **⌘+⌥+O** |

41| Quick chat (ChatGPT only) | **⌘+⌥+N** |

42| New temporary chat (ChatGPT only) | **⌘+⇧+N** |

43| Archive chat | **⌘+⇧+A** |

44| Mark chat as unread | **⌘+⇧+U** |

45| Pin or unpin chat | **⌘+⌥+P** |

46| Rename chat | **⌘+⌥+R** |

47| Open side chat (Codex only) | **⌘+⌥+S** |

48| Search chats (Assign one in Settings > Keyboard Shortcuts) | Not assigned by default |

49| Find in chat | **⌘+F** |

50| Find next match | **⌘+G** |

51| Find previous match | **⌘+⇧+G** |

52| Previous chat or tab | **⌃+⇧+Tab** or **⌘+⇧+[** or **⌘+⌥+←** |

53| Next chat or tab | **⌃+Tab** or **⌘+⇧+]** or **⌘+⌥+→** |

54| Next chat needing attention (Codex only) | **⌘+⌥+A** |

55| Open recent chat 1–6 | **⌘+⌥+1–6** |

56| Go to chat 1–9 | **⌘+1–9** |

57 

58| Input and modes | Shortcut |

59| --- | --- |

60| Open model picker | **⌃+⇧+M** |

61| Open project picker | **⌘+⌥+⇧+O** |

62| Start voice chat (When voice chat is available) | **⌃+⇧+V** |

63| Start dictation (When dictation is available) | **⌃+⇧+D** |

64| Restore previous composer prompt (When the composer is empty) | **↑** |

65| Approve request (When an approval request is open) | **⏎** |

66| Decline request (When an approval request is open) | **Esc** |

67| Switch to Chat, Work, or Codex (In the order shown) | **⌃+1** or **⌃+2** or **⌃+3** |

68| Toggle Activity view (When Activity is available) | **⌘+⌥+U** |

69 

70| Workspace and browser | Shortcut |

71| --- | --- |

72| Run environment action 1 (When the environment defines a primary action) | **⌘+⇧+D** |

73| Search files (Codex only) | **⌘+P** |

74| Toggle file tree (Codex only) | **⌘+⇧+E** |

75| Open review tab (Codex only) | **⌃+⇧+G** |

76| Toggle review panel (Codex only) | **⌘+⌥+B** |

77| Open browser tab (When the built-in browser is available) | **⌘+T** |

78| Toggle browser panel (When the built-in browser is available) | **⌘+⇧+B** |

79| Go to line or focus browser address bar (Depends on the focused view) | **⌘+L** |

80| Browser back (When the built-in browser is focused) | **⌘+←** |

81| Browser forward (When the built-in browser is focused) | **⌘+→** |

82| Reload browser page (When the built-in browser is focused) | **⌘+R** |

83| Reload browser page without cache (When the built-in browser is focused) | **⌘+⇧+R** |

84| Copy browser URL (When the built-in browser is focused) | **⌘+⇧+C** |

85| Toggle browser browse or comment mode (When browser commenting is available) | **⌘+.** |

86| Copy conversation path (Codex only) | **⌘+⌥+⇧+C** |

87| Copy chat deep link | **⌘+⌥+L** |

88| Copy session ID | **⌘+⌥+C** |

89| Copy working directory (Codex only) | **⌘+⇧+C** |

90| Take an Appshot (press both keys simultaneously) | **⌘+⌘** |

91 

92### Windows

93 

94 

95 

96| General | Shortcut |

97| --- | --- |

98| Open command menu | **Ctrl+Shift+P** or **Ctrl+K** |

99| Open settings | **Ctrl+,** |

100| Open keyboard shortcuts | **Ctrl+/** |

101| Open folder (Codex and Work only) | **Ctrl+O** |

102| Navigate back | **Ctrl+[** or **Mouse Back** |

103| Navigate forward | **Ctrl+]** or **Mouse Forward** |

104| Increase font size | **Ctrl++** or **Ctrl+=** or **Ctrl+Numpad +** |

105| Decrease font size | **Ctrl+-** or **Ctrl+Numpad −** |

106| Reset font size | **Ctrl+0** or **Ctrl+Numpad 0** |

107| Toggle sidebar | **Ctrl+B** |

108| Toggle bottom panel (Codex only) | **Ctrl+J** |

109| Toggle terminal (Codex only) | **Ctrl+`** |

110| Clear terminal (When the terminal is focused) | **Ctrl+L** or **Ctrl+K** |

111| Clear all unread indicators (Codex only) | **Shift+Esc** |

112| Undo last app action | **Ctrl+Z** |

113| Redo last app action | **Ctrl+Y** or **Ctrl+Shift+Z** |

114| Close current tab or window | **Ctrl+W** or **Ctrl+F4** |

115| Toggle full screen | **F11** |

116| Quit the app | **Ctrl+Q** |

117 

118| Chats | Shortcut |

119| --- | --- |

120| New chat | **Ctrl+N** or **Ctrl+Shift+O** |

121| New standalone chat (Codex only) | **Ctrl+Alt+O** |

122| Quick chat (ChatGPT only) | **Ctrl+Alt+N** |

123| New temporary chat (ChatGPT only) | **Ctrl+Shift+N** |

124| Archive chat | **Ctrl+Shift+A** |

125| Mark chat as unread | **Ctrl+Shift+U** |

126| Pin or unpin chat | **Ctrl+Alt+P** |

127| Rename chat | **Ctrl+Alt+R** |

128| Open side chat (Codex only) | **Ctrl+Alt+S** |

129| Search chats (Assign one in Settings > Keyboard Shortcuts) | Not assigned by default |

130| Find in chat | **Ctrl+F** |

131| Find next match | **Ctrl+G** |

132| Find previous match | **Shift+F3** |

133| Previous chat or tab | **Ctrl+Shift+Tab** or **Ctrl+Shift+[** or **Ctrl+Page Up** |

134| Next chat or tab | **Ctrl+Tab** or **Ctrl+Shift+]** or **Ctrl+Page Down** |

135| Next chat needing attention (Codex only) | **Ctrl+Alt+A** |

136| Open recent chat 1–6 | **Ctrl+Alt+1–6** |

137| Go to chat 1–9 | **Ctrl+1–9** |

138 

139| Input and modes | Shortcut |

140| --- | --- |

141| Open model picker | **Ctrl+Shift+M** |

142| Open project picker | **Ctrl+Alt+Shift+O** |

143| Start voice chat (When voice chat is available) | **Ctrl+Shift+V** |

144| Start dictation (When dictation is available) | **Ctrl+Shift+D** |

145| Restore previous composer prompt (When the composer is empty) | **↑** |

146| Approve request (When an approval request is open) | **⏎** |

147| Decline request (When an approval request is open) | **Esc** |

148| Switch to Chat, Work, or Codex (In the order shown) | **Alt+1** or **Alt+2** or **Alt+3** |

149| Toggle Activity view (When Activity is available) | **Ctrl+Alt+U** |

150 

151| Workspace and browser | Shortcut |

152| --- | --- |

153| Run environment action 1 (When the environment defines a primary action) | **Win+Shift+D** |

154| Search files (Codex only) | **Ctrl+P** |

155| Toggle file tree (Codex only) | **Ctrl+Shift+E** |

156| Open review tab (Codex only) | **Ctrl+Shift+G** |

157| Toggle review panel (Codex only) | **Ctrl+Alt+B** |

158| Open browser tab (When the built-in browser is available) | **Ctrl+T** |

159| Toggle browser panel (When the built-in browser is available) | **Ctrl+Shift+B** |

160| Go to line or focus browser address bar (Depends on the focused view) | **Ctrl+L** |

161| Browser back (When the built-in browser is focused) | **Alt+←** |

162| Browser forward (When the built-in browser is focused) | **Alt+→** |

163| Reload browser page (When the built-in browser is focused) | **Ctrl+R** |

164| Reload browser page without cache (When the built-in browser is focused) | **Ctrl+Shift+R** |

165| Copy browser URL (When the built-in browser is focused) | **Ctrl+Shift+C** |

166| Toggle browser browse or comment mode (When browser commenting is available) | **Ctrl+.** |

167| Copy chat deep link | **Ctrl+Alt+L** |

168| Copy session ID | **Ctrl+Alt+C** |

169| Copy working directory (Codex only) | **Ctrl+Shift+C** |

170 

171### Linux

172 

173 

174 

175| General | Shortcut |

176| --- | --- |

177| Open command menu | **Ctrl+Shift+P** or **Ctrl+K** |

178| Open settings | **Ctrl+,** |

179| Open keyboard shortcuts | **Ctrl+/** |

180| Open folder (Codex and Work only) | **Ctrl+O** |

181| Navigate back | **Ctrl+[** or **Mouse Back** |

182| Navigate forward | **Ctrl+]** or **Mouse Forward** |

183| Increase font size | **Ctrl++** or **Ctrl+=** or **Ctrl+Numpad +** |

184| Decrease font size | **Ctrl+-** or **Ctrl+Numpad −** |

185| Reset font size | **Ctrl+0** or **Ctrl+Numpad 0** |

186| Toggle sidebar | **Ctrl+B** |

187| Toggle bottom panel (Codex only) | **Ctrl+J** |

188| Toggle terminal (Codex only) | **Ctrl+`** |

189| Clear terminal (When the terminal is focused) | **Ctrl+L** or **Ctrl+K** |

190| Clear all unread indicators (Codex only) | **Shift+Esc** |

191| Undo last app action | **Ctrl+Z** |

192| Redo last app action | **Ctrl+Y** or **Ctrl+Shift+Z** |

193| Close current tab or window | **Ctrl+W** or **Ctrl+F4** |

194| Toggle full screen | **F11** |

195| Quit the app | **Ctrl+Q** |

196 

197| Chats | Shortcut |

198| --- | --- |

199| New chat | **Ctrl+N** or **Ctrl+Shift+O** |

200| New standalone chat (Codex only) | **Ctrl+Alt+O** |

201| Quick chat (ChatGPT only) | **Ctrl+Alt+N** |

202| New temporary chat (ChatGPT only) | **Ctrl+Shift+N** |

203| Archive chat | **Ctrl+Shift+A** |

204| Mark chat as unread | **Ctrl+Shift+U** |

205| Pin or unpin chat | **Ctrl+Alt+P** |

206| Rename chat | **Ctrl+Alt+R** |

207| Open side chat (Codex only) | **Ctrl+Alt+S** |

208| Search chats (Assign one in Settings > Keyboard Shortcuts) | Not assigned by default |

209| Find in chat | **Ctrl+F** |

210| Find next match | **Ctrl+G** |

211| Find previous match | **Shift+F3** |

212| Previous chat or tab | **Ctrl+Shift+Tab** or **Ctrl+Shift+[** or **Ctrl+Page Up** |

213| Next chat or tab | **Ctrl+Tab** or **Ctrl+Shift+]** or **Ctrl+Page Down** |

214| Next chat needing attention (Codex only) | **Ctrl+Alt+A** |

215| Open recent chat 1–6 | **Ctrl+Alt+1–6** |

216| Go to chat 1–9 | **Ctrl+1–9** |

217 

218| Input and modes | Shortcut |

219| --- | --- |

220| Open model picker | **Ctrl+Shift+M** |

221| Open project picker | **Ctrl+Alt+Shift+O** |

222| Start voice chat (When voice chat is available) | **Ctrl+Shift+V** |

223| Start dictation (When dictation is available) | **Ctrl+Shift+D** |

224| Restore previous composer prompt (When the composer is empty) | **↑** |

225| Approve request (When an approval request is open) | **⏎** |

226| Decline request (When an approval request is open) | **Esc** |

227| Switch to Chat, Work, or Codex (In the order shown) | **Alt+1** or **Alt+2** or **Alt+3** |

228| Toggle Activity view (When Activity is available) | **Ctrl+Alt+U** |

229 

230| Workspace and browser | Shortcut |

231| --- | --- |

232| Run environment action 1 (When the environment defines a primary action) | **Super+Shift+D** |

233| Search files (Codex only) | **Ctrl+P** |

234| Toggle file tree (Codex only) | **Ctrl+Shift+E** |

235| Open review tab (Codex only) | **Ctrl+Shift+G** |

236| Toggle review panel (Codex only) | **Ctrl+Alt+B** |

237| Open browser tab (When the built-in browser is available) | **Ctrl+T** |

238| Toggle browser panel (When the built-in browser is available) | **Ctrl+Shift+B** |

239| Go to line or focus browser address bar (Depends on the focused view) | **Ctrl+L** |

240| Browser back (When the built-in browser is focused) | **Alt+←** |

241| Browser forward (When the built-in browser is focused) | **Alt+→** |

242| Reload browser page (When the built-in browser is focused) | **Ctrl+R** |

243| Reload browser page without cache (When the built-in browser is focused) | **Ctrl+Shift+R** |

244| Copy browser URL (When the built-in browser is focused) | **Ctrl+Shift+C** |

245| Toggle browser browse or comment mode (When browser commenting is available) | **Ctrl+.** |

246| Copy chat deep link | **Ctrl+Alt+L** |

247| Copy session ID | **Ctrl+Alt+C** |

248| Copy working directory (Codex only) | **Ctrl+Shift+C** |To find, customize, or reset app shortcuts, open **Settings > Keyboard

249Shortcuts**.

250 

35You can search by command name or switch the search field into keystroke mode251You can search by command name or switch the search field into keystroke mode

36and press the shortcut you want to find.252and press the shortcut you want to find. Appshots use a separate global shortcut

253under **Settings > Appshots**.

254 

255On Linux, experimental native Wayland can affect shortcut support. See the

256[Linux desktop app guide](https://learn.chatgpt.com/docs/linux/linux-app#wayland-support).

37 257 

38<a id="search-past-tasks-and-find-in-a-task"></a>258<a id="search-past-tasks-and-find-in-a-task"></a>

39 259 

40## Search past chats and find in a chat260## Search past chats and find in a chat

41 261 

42Use chat search (<kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>G</kbd>) to reopen a past262Use **Search chats** to reopen a past chat. Search chats doesn't have a default

43chat. When expanded matching is available, it can also match chat content and263shortcut. You can assign one under **Settings > Keyboard Shortcuts**. When

44Git branch names, so you can search for a phrase from the chat or a264expanded matching is available, search can also match chat content and Git

45branch such as `fix/login-redirect`.265branch names, so you can search for a phrase from the chat or a branch such as

266`fix/login-redirect`.

46 267 

47Use **Find in chat** (<kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>F</kbd>) after opening268Use **Find in chat** after opening a chat to find text within it. It doesn't

48a chat to find text within it. It doesn't search across other chats.269search across other chats.

49 270 

50For actions that start with `/`, see [Slash commands](https://learn.chatgpt.com/docs/reference/slash-commands).271For actions that start with `/`, see [Slash commands](https://learn.chatgpt.com/docs/reference/slash-commands).

51 272 

import.md +10 −14

Details

13 13 

14Importing doesn't change or delete your existing agent setup.14Importing doesn't change or delete your existing agent setup.

15 15 

16<Illustration description="ChatGPT import screen for choosing other AI apps to import from.">16 

17 <ExternalAgentImportIllustration17 

18 step="providers"18> Illustration: ChatGPT import screen for choosing other AI apps to import from.

19 providers={[19 

20 { label: "Claude Code", icon: "code", selected: true },20 

21 { label: "Claude Cowork", icon: "tasks", selected: true },

22 { label: "Cursor", icon: "code", selected: true },

23 ]}

24 note="Your existing agent setup won't be affected."

25 />

26</Illustration>

27 21 

28## Start an import22## Start an import

29 23 


60to a local app-server daemon. See [CLI slash54to a local app-server daemon. See [CLI slash

61commands](https://learn.chatgpt.com/docs/developer-commands?surface=cli#cli-import-claude-code-or-cursor-setup-with-import).55commands](https://learn.chatgpt.com/docs/developer-commands?surface=cli#cli-import-claude-code-or-cursor-setup-with-import).

62 56 

63<Illustration description="ChatGPT import screen for selecting setup, projects, and recent chats to import.">57 

64 <ExternalAgentImportIllustration step="items" />58 

65</Illustration>59> Illustration: ChatGPT import screen for selecting setup, projects, and recent chats to import.

60 

61 

66 62 

67## How importing works63## How importing works

68 64 

Details

6worktree. Open it from the terminal icon in the top-right corner of the app, or6worktree. Open it from the terminal icon in the top-right corner of the app, or

7press <kbd>Ctrl</kbd>+<kbd>`</kbd>.7press <kbd>Ctrl</kbd>+<kbd>`</kbd>.

8 8 

9<CodexScreenshot9 

10 alt="Integrated terminal drawer open beneath a ChatGPT chat"10

11 lightSrc="/images/codex/app/integrated-terminal-light.webp"11 

12 darkSrc="/images/codex/app/integrated-terminal-dark.webp"12> Illustration: Integrated terminal drawer open beneath a ChatGPT chat

13 maxHeight="400px"13 

14 class="my-8"14 

15/>15 

16 16 

17## Run and validate your project17## Run and validate your project

18 18 

Details

35 35 

36 36 

37 37 

38 <img src="https://developers.openai.com/images/codex/code-review/code-review-settings.png"38

39 alt="Codex settings showing the Code review toggle"39

40 class="block h-auto w-full mx-0!"40 

41 />41> Illustration: Codex settings showing the Code review toggle

42 

43 

44

42 45 

43 46 

44 47 


51 54 

52 55 

53 56 

54 <img src="https://developers.openai.com/images/codex/code-review/review-trigger.png"57

55 alt="A pull request comment with @codex review"58

56 class="block h-auto w-full mx-0!"59 

57 />60> Illustration: A pull request comment with @codex review

61 

62 

63

58 64 

59 65 

60 66 


66 72 

67 73 

68 74 

69 <img src="https://developers.openai.com/images/codex/code-review/review-example.png"75

70 alt="Example Codex code review on a pull request"76

71 class="block h-auto w-full mx-0!"77 

72 />78> Illustration: Example Codex code review on a pull request

79 

80 

81

73 82 

74 83 

75 84 

Details

24 24 

25 25 

26 26 

27 <img src="https://developers.openai.com/images/codex/integrations/linear-assign-codex-light.webp"27

28 alt="Assigning Codex to a Linear issue (light mode)"28

29 class="block h-auto w-full rounded-lg border border-default my-0 dark:hidden"29 

30 />30> Illustration: Assigning Codex to a Linear issue

31 <img src="https://developers.openai.com/images/codex/integrations/linear-assign-codex-dark.webp"31 

32 alt="Assigning Codex to a Linear issue (dark mode)"32 

33 class="hidden h-auto w-full rounded-lg border border-default my-0 dark:block"33

34 />

35 34 

36 35 

37 36 


41 40 

42 41 

43 42 

44 <img src="https://developers.openai.com/images/codex/integrations/linear-comment-light.webp"43

45 alt="Mentioning Codex in a Linear issue comment (light mode)"44

46 class="block h-auto w-full rounded-lg border border-default my-0 dark:hidden"45 

47 />46> Illustration: Mentioning Codex in a Linear issue comment

48 <img src="https://developers.openai.com/images/codex/integrations/linear-comment-dark.webp"47 

49 alt="Mentioning Codex in a Linear issue comment (dark mode)"48 

50 class="hidden h-auto w-full rounded-lg border border-default my-0 dark:block"49

51 />

52 50 

53 51 

54 52 


82 80 

83 81 

84 82 

85 <img src="https://developers.openai.com/images/codex/integrations/linear-triage-rule-light.webp"83

86 alt='Screenshot of an example triage rule assigning everything to Codex and labeling it in the "Triage" status (light mode)'84

87 class="block h-auto w-full rounded-lg border border-default my-0 dark:hidden"85 

88 />86> Illustration: Linear triage rule automatically assigning issues to Codex

89 <img src="https://developers.openai.com/images/codex/integrations/linear-triage-rule-dark.webp"87 

90 alt='Screenshot of an example triage rule assigning everything to Codex and labeling it in the "Triage" status (dark mode)'88 

91 class="hidden h-auto w-full rounded-lg border border-default my-0 dark:block"89

92 />

93 90 

94 91 

95 92 

Details

6 6 

7 7 

8 8 

9 <img src="https://developers.openai.com/images/codex/integrations/slack-example.png"9

10 alt="Codex Slack integration in action"10

11 class="block h-auto w-full mx-0!"11 

12 />12> Illustration: Codex Slack integration in action

13 

14 

15

13 16 

14 17 

15 18 

Details

43 43 

44<ContentModeSwitch group="codex-surface" id="app">44<ContentModeSwitch group="codex-surface" id="app">

45 45 

46<CodexScreenshot46 

47 alt="ChatGPT desktop app goal progress controls above the composer"47

48 lightSrc="/images/codex/app/goal-dialog-light.webp"48 

49 darkSrc="/images/codex/app/goal-dialog-dark.webp"49> Illustration: ChatGPT desktop app goal progress controls above the composer

50 class="my-8"50 

51/>51 

52 

52 53 

53</ContentModeSwitch>54</ContentModeSwitch>

54 55 

Details

26**Permissions**. Enabling a mode makes it available in the menu; it doesn't26**Permissions**. Enabling a mode makes it available in the menu; it doesn't

27select the mode or change an existing chat.27select the mode or change an existing chat.

28 28 

29<Illustration description="Permission visibility controls showing Default permissions, automatic review, and Full access.">29 

30 <PermissionModeSettingsIllustration ariaLabel="Permission visibility controls showing Default permissions, automatic review, and Full access." />30 

31</Illustration>31> Illustration: Permission visibility controls showing Default permissions, automatic review, and Full access.

32 

33 

32 34 

33The available modes can depend on your local configuration and your35The available modes can depend on your local configuration and your

34 organization's requirements. A mode that isn't allowed appears disabled.36 organization's requirements. A mode that isn't allowed appears disabled.

plugins.md +21 −15

Details

102 102 

103<ContentModeSwitch group="codex-surface" id="app">103<ContentModeSwitch group="codex-surface" id="app">

104 104 

105<CodexScreenshot105 

106 alt="Plugins Directory in the ChatGPT desktop app"106

107 lightSrc="/images/codex/plugins/directory.webp"107 

108 darkSrc="/images/codex/plugins/directory-dark.webp"108> Illustration: Plugins Directory in the ChatGPT desktop app

109/>109 

110 

111 

110 112 

111</ContentModeSwitch>113</ContentModeSwitch>

112 114 


155 157 

156<ContentModeSwitch group="codex-surface" id="app">158<ContentModeSwitch group="codex-surface" id="app">

157 159 

158<CodexScreenshot160 

159 alt="Installed plugin on the Plugins page"161

160 lightSrc="/images/codex/plugins/plugin-github-invoke.png"162 

161 darkSrc="/images/codex/plugins/plugin-github-invoke-dark.png"163> Illustration: Installed plugin on the Plugins page

162/>164 

165 

166 

163 167 

164</ContentModeSwitch>168</ContentModeSwitch>

165 169 


273/plugins277/plugins

274```278```

275 279 

276<CodexScreenshot280 

277 alt="Plugins list in Codex CLI"281

278 lightSrc="/images/codex/plugins/cli_light.png"282 

279 darkSrc="/images/codex/plugins/codex-plugin-cli.png"283> Illustration: Plugins list in Codex CLI

280/>284 

285 

286 

281 287 

282The CLI plugin browser groups plugins by marketplace. Use the marketplace tabs288The CLI plugin browser groups plugins by marketplace. Use the marketplace tabs

283to switch sources, open a plugin to inspect details, install or uninstall289to switch sources, open a plugin to inspect details, install or uninstall

plugins/build.md +14 −10

Details

31For the fastest setup, use the built-in `@plugin-creator` skill in ChatGPT Work31For the fastest setup, use the built-in `@plugin-creator` skill in ChatGPT Work

32mode or `$plugin-creator` in Codex.32mode or `$plugin-creator` in Codex.

33 33 

34<CodexScreenshot34 

35 alt="Plugin creator skill in ChatGPT"35

36 lightSrc="/images/codex/plugins/plugin-creator.png"36 

37 darkSrc="/images/codex/plugins/plugin-creator-dark.png"37> Illustration: Plugin creator skill in ChatGPT

38/>38 

39 

40 

39 41 

40Describe the outcome, the skills or MCP server to include, and whether you want42Describe the outcome, the skills or MCP server to include, and whether you want

41a local marketplace entry for testing. For example:43a local marketplace entry for testing. For example:


49The skill creates the required `.codex-plugin/plugin.json` manifest, organizes51The skill creates the required `.codex-plugin/plugin.json` manifest, organizes

50the plugin folder, and can add the plugin to a local marketplace.52the plugin folder, and can add the plugin to a local marketplace.

51 53 

52<CodexScreenshot54 

53 alt="Invoking the plugin creator skill"55

54 lightSrc="/images/codex/plugins/plugin-creator-invoke.png"56 

55 darkSrc="/images/codex/plugins/plugin-creator-invoke-dark.png"57> Illustration: Invoking the plugin creator skill

56/>58 

59 

60 

57 61 

58After it finishes:62After it finishes:

59 63 

projects.md +14 −12

Details

68Start a separate chat for each distinct outcome so its messages and results stay68Start a separate chat for each distinct outcome so its messages and results stay

69focused while the project keeps related work organized.69focused while the project keeps related work organized.

70 70 

71<CodexScreenshot71 

72 alt="ChatGPT desktop app showing multiple projects in the sidebar and chats in the main pane"72

73 lightSrc="/images/codex/app/multitask-light.webp"73 

74 darkSrc="/images/codex/app/multitask-dark.webp"74> Illustration: ChatGPT desktop app showing multiple projects in the sidebar and chats in the main pane

75 maxHeight="400px"75 

76 class="my-8"76 

77/>77 

78 78 

79</ContentModeSwitch>79</ContentModeSwitch>

80 80 


136 project.136 project.

137- **Rename a chat** with a short title that describes its outcome, such as “Q3137- **Rename a chat** with a short title that describes its outcome, such as “Q3

138 launch brief” or “Checkout accessibility review.”138 launch brief” or “Checkout accessibility review.”

139- **Search projects** from the Projects view. Press139- **Search projects** from the Projects view. Open **Search chats** from the

140 <kbd>Cmd</kbd>/<kbd>Ctrl</kbd>+<kbd>G</kbd> to search past chats when you140 sidebar to find a past chat when you remember a phrase or branch name but not

141 remember a phrase or branch name but not the title.141 the title. Search chats doesn't have a default shortcut, but you can assign

142 one under **Settings > Keyboard Shortcuts**.

142- **Archive a chat** when you finish the work. From a project's menu, select143- **Archive a chat** when you finish the work. From a project's menu, select

143 **Archive chats** to archive its chats together.144 **Archive chats** to archive its chats together.

144 145 


261Point to **New chat**, then select the **Quick chat** icon on its right. You can262Point to **New chat**, then select the **Quick chat** icon on its right. You can

262also press263also press

263 264 

264<kbd>Cmd+Option+N</kbd> on macOS or <kbd>Ctrl+Alt+N</kbd> on Windows. From **New265<kbd>Cmd+Option+N</kbd> on macOS or <kbd>Ctrl+Alt+N</kbd> on Windows and Linux.

265chat**, you can open an existing ChatGPT chat and add it to a Codex chat.266From **New chat**, you can open an existing ChatGPT chat and add it to a Codex

267chat.

266 268 

267</ContentModeSwitch>269</ContentModeSwitch>

268 270 

quickstart.md +7 −5

Details

8[ChatGPT desktop app](https://learn.chatgpt.com/docs/app) and [ChatGPT on the web](https://learn.chatgpt.com/docs/web). Choose8[ChatGPT desktop app](https://learn.chatgpt.com/docs/app) and [ChatGPT on the web](https://learn.chatgpt.com/docs/web). Choose

9the option that fits your work.9the option that fits your work.

10 10 

11<Illustration description="Cards compare the ChatGPT desktop app and ChatGPT on the web">11 

12 <QuickstartSetupSelector />12 

13</Illustration>13> Illustration: Cards compare the ChatGPT desktop app and ChatGPT on the web

14 

15 

14 16 

15If you're a developer and want to use Codex in your terminal or code editor,17If you're a developer and want to use Codex in your terminal or code editor,

16 try [Codex CLI](https://learn.chatgpt.com/docs/codex/cli) or the [Codex IDE extension](https://learn.chatgpt.com/docs/codex/ide).18 try [Codex CLI](https://learn.chatgpt.com/docs/codex/cli) or the [Codex IDE extension](https://learn.chatgpt.com/docs/codex/ide).


75 77

76 78 

77 79 

78 <ChatGPTModeDropdown client:load />80 <ChatGPTModeDropdown client:visible />

79 81 

80 82

81 83 


138 140

139 141 

140 142 

141 <ChatWorkSegmentPicker client:load />143 <ChatWorkSegmentPicker client:visible />

142 144 

143 145

144 146 

Details

6 6 

7## Keyboard shortcuts7## Keyboard shortcuts

8 8 

9| | Action | Shortcut |9Choose your platform to see its default shortcuts. Some shortcuts appear only when the corresponding feature or view is available.

10| ----------- | ------------------- | ---------------------------------------------------------------------------------------------------------------------- |10 

11| **General** | | |11### macOS

12| | Command menu | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> or <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>K</kbd> |12 

13| | Settings | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>,</kbd> |13 

14| | Keyboard shortcuts | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>/</kbd> |14 

15| | Open folder | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>O</kbd> |15| General | Shortcut |

16| | Navigate back | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>[</kbd> |16| --- | --- |

17| | Navigate forward | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>]</kbd> |17| Open command menu | **⌘+⇧+P** or **⌘+K** |

18| | Increase font size | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>+</kbd> |18| Open settings | **⌘+,** |

19| | Decrease font size | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>-</kbd> |19| Open keyboard shortcuts | **⌘+/** |

20| | Toggle sidebar | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>B</kbd> |20| Open folder (Codex and Work only) | **⌘+O** |

21| | Open review tab | <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>G</kbd> |21| Navigate back | **⌘+[** or **Mouse Back** |

22| | Toggle review panel | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>B</kbd> |22| Navigate forward | **⌘+]** or **Mouse Forward** |

23| | Toggle bottom panel | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>J</kbd> |23| Increase font size | **⌘++** or **⌘+Numpad +** |

24| | Toggle terminal | <kbd>Ctrl</kbd> + <kbd>`</kbd> |24| Decrease font size | **⌘+-** or **⌘+Numpad −** |

25| | Clear the terminal | <kbd>Ctrl</kbd> + <kbd>L</kbd> |25| Reset font size | **⌘+0** or **⌘+Numpad 0** |

26| **Chat** | Quick chat | <kbd>Cmd</kbd> + <kbd>Option</kbd> + <kbd>N</kbd> (macOS) or <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>N</kbd> (Windows) |26| Toggle sidebar | **⌘+B** |

27| | New chat | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>N</kbd> or <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>O</kbd> |27| Toggle bottom panel (Codex only) | **⌘+J** |

28| | Search chats | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>G</kbd> |28| Toggle terminal (Codex only) | **⌃+`** |

29| | Find in chat | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>F</kbd> |29| Clear terminal (When the terminal is focused) | **⌃+L** or **⌘+K** |

30| | Previous chat | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>[</kbd> |30| Clear all unread indicators (Codex only) | **⇧+Esc** |

31| | Next chat | <kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>]</kbd> |31| Undo last app action | **⌘+Z** |

32| **Input** | Dictation | <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>D</kbd> |32| Redo last app action | **⌘+⇧+Z** |

33 33| Close current tab or window | **⌘+W** |

34To find, customize, or reset shortcuts, open **Settings > Keyboard Shortcuts**.34| Toggle full screen | **⌘+⌃+F** |

35| Quit the app | **⌘+Q** |

36 

37| Chats | Shortcut |

38| --- | --- |

39| New chat | **⌘+N** or **⌘+⇧+O** |

40| New standalone chat (Codex only) | **⌘+⌥+O** |

41| Quick chat (ChatGPT only) | **⌘+⌥+N** |

42| New temporary chat (ChatGPT only) | **⌘+⇧+N** |

43| Archive chat | **⌘+⇧+A** |

44| Mark chat as unread | **⌘+⇧+U** |

45| Pin or unpin chat | **⌘+⌥+P** |

46| Rename chat | **⌘+⌥+R** |

47| Open side chat (Codex only) | **⌘+⌥+S** |

48| Search chats (Assign one in Settings > Keyboard Shortcuts) | Not assigned by default |

49| Find in chat | **⌘+F** |

50| Find next match | **⌘+G** |

51| Find previous match | **⌘+⇧+G** |

52| Previous chat or tab | **⌃+⇧+Tab** or **⌘+⇧+[** or **⌘+⌥+←** |

53| Next chat or tab | **⌃+Tab** or **⌘+⇧+]** or **⌘+⌥+→** |

54| Next chat needing attention (Codex only) | **⌘+⌥+A** |

55| Open recent chat 1–6 | **⌘+⌥+1–6** |

56| Go to chat 1–9 | **⌘+1–9** |

57 

58| Input and modes | Shortcut |

59| --- | --- |

60| Open model picker | **⌃+⇧+M** |

61| Open project picker | **⌘+⌥+⇧+O** |

62| Start voice chat (When voice chat is available) | **⌃+⇧+V** |

63| Start dictation (When dictation is available) | **⌃+⇧+D** |

64| Restore previous composer prompt (When the composer is empty) | **↑** |

65| Approve request (When an approval request is open) | **⏎** |

66| Decline request (When an approval request is open) | **Esc** |

67| Switch to Chat, Work, or Codex (In the order shown) | **⌃+1** or **⌃+2** or **⌃+3** |

68| Toggle Activity view (When Activity is available) | **⌘+⌥+U** |

69 

70| Workspace and browser | Shortcut |

71| --- | --- |

72| Run environment action 1 (When the environment defines a primary action) | **⌘+⇧+D** |

73| Search files (Codex only) | **⌘+P** |

74| Toggle file tree (Codex only) | **⌘+⇧+E** |

75| Open review tab (Codex only) | **⌃+⇧+G** |

76| Toggle review panel (Codex only) | **⌘+⌥+B** |

77| Open browser tab (When the built-in browser is available) | **⌘+T** |

78| Toggle browser panel (When the built-in browser is available) | **⌘+⇧+B** |

79| Go to line or focus browser address bar (Depends on the focused view) | **⌘+L** |

80| Browser back (When the built-in browser is focused) | **⌘+←** |

81| Browser forward (When the built-in browser is focused) | **⌘+→** |

82| Reload browser page (When the built-in browser is focused) | **⌘+R** |

83| Reload browser page without cache (When the built-in browser is focused) | **⌘+⇧+R** |

84| Copy browser URL (When the built-in browser is focused) | **⌘+⇧+C** |

85| Toggle browser browse or comment mode (When browser commenting is available) | **⌘+.** |

86| Copy conversation path (Codex only) | **⌘+⌥+⇧+C** |

87| Copy chat deep link | **⌘+⌥+L** |

88| Copy session ID | **⌘+⌥+C** |

89| Copy working directory (Codex only) | **⌘+⇧+C** |

90| Take an Appshot (press both keys simultaneously) | **⌘+⌘** |

91 

92### Windows

93 

94 

95 

96| General | Shortcut |

97| --- | --- |

98| Open command menu | **Ctrl+Shift+P** or **Ctrl+K** |

99| Open settings | **Ctrl+,** |

100| Open keyboard shortcuts | **Ctrl+/** |

101| Open folder (Codex and Work only) | **Ctrl+O** |

102| Navigate back | **Ctrl+[** or **Mouse Back** |

103| Navigate forward | **Ctrl+]** or **Mouse Forward** |

104| Increase font size | **Ctrl++** or **Ctrl+=** or **Ctrl+Numpad +** |

105| Decrease font size | **Ctrl+-** or **Ctrl+Numpad −** |

106| Reset font size | **Ctrl+0** or **Ctrl+Numpad 0** |

107| Toggle sidebar | **Ctrl+B** |

108| Toggle bottom panel (Codex only) | **Ctrl+J** |

109| Toggle terminal (Codex only) | **Ctrl+`** |

110| Clear terminal (When the terminal is focused) | **Ctrl+L** or **Ctrl+K** |

111| Clear all unread indicators (Codex only) | **Shift+Esc** |

112| Undo last app action | **Ctrl+Z** |

113| Redo last app action | **Ctrl+Y** or **Ctrl+Shift+Z** |

114| Close current tab or window | **Ctrl+W** or **Ctrl+F4** |

115| Toggle full screen | **F11** |

116| Quit the app | **Ctrl+Q** |

117 

118| Chats | Shortcut |

119| --- | --- |

120| New chat | **Ctrl+N** or **Ctrl+Shift+O** |

121| New standalone chat (Codex only) | **Ctrl+Alt+O** |

122| Quick chat (ChatGPT only) | **Ctrl+Alt+N** |

123| New temporary chat (ChatGPT only) | **Ctrl+Shift+N** |

124| Archive chat | **Ctrl+Shift+A** |

125| Mark chat as unread | **Ctrl+Shift+U** |

126| Pin or unpin chat | **Ctrl+Alt+P** |

127| Rename chat | **Ctrl+Alt+R** |

128| Open side chat (Codex only) | **Ctrl+Alt+S** |

129| Search chats (Assign one in Settings > Keyboard Shortcuts) | Not assigned by default |

130| Find in chat | **Ctrl+F** |

131| Find next match | **Ctrl+G** |

132| Find previous match | **Shift+F3** |

133| Previous chat or tab | **Ctrl+Shift+Tab** or **Ctrl+Shift+[** or **Ctrl+Page Up** |

134| Next chat or tab | **Ctrl+Tab** or **Ctrl+Shift+]** or **Ctrl+Page Down** |

135| Next chat needing attention (Codex only) | **Ctrl+Alt+A** |

136| Open recent chat 1–6 | **Ctrl+Alt+1–6** |

137| Go to chat 1–9 | **Ctrl+1–9** |

138 

139| Input and modes | Shortcut |

140| --- | --- |

141| Open model picker | **Ctrl+Shift+M** |

142| Open project picker | **Ctrl+Alt+Shift+O** |

143| Start voice chat (When voice chat is available) | **Ctrl+Shift+V** |

144| Start dictation (When dictation is available) | **Ctrl+Shift+D** |

145| Restore previous composer prompt (When the composer is empty) | **↑** |

146| Approve request (When an approval request is open) | **⏎** |

147| Decline request (When an approval request is open) | **Esc** |

148| Switch to Chat, Work, or Codex (In the order shown) | **Alt+1** or **Alt+2** or **Alt+3** |

149| Toggle Activity view (When Activity is available) | **Ctrl+Alt+U** |

150 

151| Workspace and browser | Shortcut |

152| --- | --- |

153| Run environment action 1 (When the environment defines a primary action) | **Win+Shift+D** |

154| Search files (Codex only) | **Ctrl+P** |

155| Toggle file tree (Codex only) | **Ctrl+Shift+E** |

156| Open review tab (Codex only) | **Ctrl+Shift+G** |

157| Toggle review panel (Codex only) | **Ctrl+Alt+B** |

158| Open browser tab (When the built-in browser is available) | **Ctrl+T** |

159| Toggle browser panel (When the built-in browser is available) | **Ctrl+Shift+B** |

160| Go to line or focus browser address bar (Depends on the focused view) | **Ctrl+L** |

161| Browser back (When the built-in browser is focused) | **Alt+←** |

162| Browser forward (When the built-in browser is focused) | **Alt+→** |

163| Reload browser page (When the built-in browser is focused) | **Ctrl+R** |

164| Reload browser page without cache (When the built-in browser is focused) | **Ctrl+Shift+R** |

165| Copy browser URL (When the built-in browser is focused) | **Ctrl+Shift+C** |

166| Toggle browser browse or comment mode (When browser commenting is available) | **Ctrl+.** |

167| Copy chat deep link | **Ctrl+Alt+L** |

168| Copy session ID | **Ctrl+Alt+C** |

169| Copy working directory (Codex only) | **Ctrl+Shift+C** |

170 

171### Linux

172 

173 

174 

175| General | Shortcut |

176| --- | --- |

177| Open command menu | **Ctrl+Shift+P** or **Ctrl+K** |

178| Open settings | **Ctrl+,** |

179| Open keyboard shortcuts | **Ctrl+/** |

180| Open folder (Codex and Work only) | **Ctrl+O** |

181| Navigate back | **Ctrl+[** or **Mouse Back** |

182| Navigate forward | **Ctrl+]** or **Mouse Forward** |

183| Increase font size | **Ctrl++** or **Ctrl+=** or **Ctrl+Numpad +** |

184| Decrease font size | **Ctrl+-** or **Ctrl+Numpad −** |

185| Reset font size | **Ctrl+0** or **Ctrl+Numpad 0** |

186| Toggle sidebar | **Ctrl+B** |

187| Toggle bottom panel (Codex only) | **Ctrl+J** |

188| Toggle terminal (Codex only) | **Ctrl+`** |

189| Clear terminal (When the terminal is focused) | **Ctrl+L** or **Ctrl+K** |

190| Clear all unread indicators (Codex only) | **Shift+Esc** |

191| Undo last app action | **Ctrl+Z** |

192| Redo last app action | **Ctrl+Y** or **Ctrl+Shift+Z** |

193| Close current tab or window | **Ctrl+W** or **Ctrl+F4** |

194| Toggle full screen | **F11** |

195| Quit the app | **Ctrl+Q** |

196 

197| Chats | Shortcut |

198| --- | --- |

199| New chat | **Ctrl+N** or **Ctrl+Shift+O** |

200| New standalone chat (Codex only) | **Ctrl+Alt+O** |

201| Quick chat (ChatGPT only) | **Ctrl+Alt+N** |

202| New temporary chat (ChatGPT only) | **Ctrl+Shift+N** |

203| Archive chat | **Ctrl+Shift+A** |

204| Mark chat as unread | **Ctrl+Shift+U** |

205| Pin or unpin chat | **Ctrl+Alt+P** |

206| Rename chat | **Ctrl+Alt+R** |

207| Open side chat (Codex only) | **Ctrl+Alt+S** |

208| Search chats (Assign one in Settings > Keyboard Shortcuts) | Not assigned by default |

209| Find in chat | **Ctrl+F** |

210| Find next match | **Ctrl+G** |

211| Find previous match | **Shift+F3** |

212| Previous chat or tab | **Ctrl+Shift+Tab** or **Ctrl+Shift+[** or **Ctrl+Page Up** |

213| Next chat or tab | **Ctrl+Tab** or **Ctrl+Shift+]** or **Ctrl+Page Down** |

214| Next chat needing attention (Codex only) | **Ctrl+Alt+A** |

215| Open recent chat 1–6 | **Ctrl+Alt+1–6** |

216| Go to chat 1–9 | **Ctrl+1–9** |

217 

218| Input and modes | Shortcut |

219| --- | --- |

220| Open model picker | **Ctrl+Shift+M** |

221| Open project picker | **Ctrl+Alt+Shift+O** |

222| Start voice chat (When voice chat is available) | **Ctrl+Shift+V** |

223| Start dictation (When dictation is available) | **Ctrl+Shift+D** |

224| Restore previous composer prompt (When the composer is empty) | **↑** |

225| Approve request (When an approval request is open) | **⏎** |

226| Decline request (When an approval request is open) | **Esc** |

227| Switch to Chat, Work, or Codex (In the order shown) | **Alt+1** or **Alt+2** or **Alt+3** |

228| Toggle Activity view (When Activity is available) | **Ctrl+Alt+U** |

229 

230| Workspace and browser | Shortcut |

231| --- | --- |

232| Run environment action 1 (When the environment defines a primary action) | **Super+Shift+D** |

233| Search files (Codex only) | **Ctrl+P** |

234| Toggle file tree (Codex only) | **Ctrl+Shift+E** |

235| Open review tab (Codex only) | **Ctrl+Shift+G** |

236| Toggle review panel (Codex only) | **Ctrl+Alt+B** |

237| Open browser tab (When the built-in browser is available) | **Ctrl+T** |

238| Toggle browser panel (When the built-in browser is available) | **Ctrl+Shift+B** |

239| Go to line or focus browser address bar (Depends on the focused view) | **Ctrl+L** |

240| Browser back (When the built-in browser is focused) | **Alt+←** |

241| Browser forward (When the built-in browser is focused) | **Alt+→** |

242| Reload browser page (When the built-in browser is focused) | **Ctrl+R** |

243| Reload browser page without cache (When the built-in browser is focused) | **Ctrl+Shift+R** |

244| Copy browser URL (When the built-in browser is focused) | **Ctrl+Shift+C** |

245| Toggle browser browse or comment mode (When browser commenting is available) | **Ctrl+.** |

246| Copy chat deep link | **Ctrl+Alt+L** |

247| Copy session ID | **Ctrl+Alt+C** |

248| Copy working directory (Codex only) | **Ctrl+Shift+C** |To find, customize, or reset app shortcuts, open **Settings > Keyboard

249Shortcuts**.

250 

35You can search by command name or switch the search field into keystroke mode251You can search by command name or switch the search field into keystroke mode

36and press the shortcut you want to find.252and press the shortcut you want to find. Appshots use a separate global shortcut

253under **Settings > Appshots**.

254 

255On Linux, experimental native Wayland can affect shortcut support. See the

256[Linux desktop app guide](https://learn.chatgpt.com/docs/linux/linux-app#wayland-support).

37 257 

38<a id="search-past-tasks-and-find-in-a-task"></a>258<a id="search-past-tasks-and-find-in-a-task"></a>

39 259 

40## Search past chats and find in a chat260## Search past chats and find in a chat

41 261 

42Use chat search (<kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>G</kbd>) to reopen a past262Use **Search chats** to reopen a past chat. Search chats doesn't have a default

43chat. When expanded matching is available, it can also match chat content and263shortcut. You can assign one under **Settings > Keyboard Shortcuts**. When

44Git branch names, so you can search for a phrase from the chat or a264expanded matching is available, search can also match chat content and Git

45branch such as `fix/login-redirect`.265branch names, so you can search for a phrase from the chat or a branch such as

266`fix/login-redirect`.

46 267 

47Use **Find in chat** (<kbd>Cmd</kbd>/<kbd>Ctrl</kbd> + <kbd>F</kbd>) after opening268Use **Find in chat** after opening a chat to find text within it. It doesn't

48a chat to find text within it. It doesn't search across other chats.269search across other chats.

49 270 

50For actions that start with `/`, see [Slash commands](https://learn.chatgpt.com/docs/reference/slash-commands).271For actions that start with `/`, see [Slash commands](https://learn.chatgpt.com/docs/reference/slash-commands).

51 272 

Details

46adjusting accent, background, and foreground colors, and changing the UI and46adjusting accent, background, and foreground colors, and changing the UI and

47code fonts. You can also share your custom theme with friends.47code fonts. You can also share your custom theme with friends.

48 48 

49<CodexScreenshot49 

50 alt="ChatGPT desktop app Appearance settings showing theme selection, color controls, and font options"50

51 lightSrc="/images/codex/app/theme-selection-light.webp"51 

52 darkSrc="/images/codex/app/theme-selection-dark.webp"52> Illustration: ChatGPT desktop app Appearance settings showing theme selection, color controls, and font options

53 maxHeight="720px"53 

54 class="mb-8"54 

55/>55 

56 56 

57## Pets57## Pets

58 58 


128next to your browser, editor, or design preview. Turn on **Always on top** when128next to your browser, editor, or design preview. Turn on **Always on top** when

129you want the chat to remain visible while you work in another app.129you want the chat to remain visible while you work in another app.

130 130 

131<CodexScreenshot131 

132 alt="ChatGPT desktop app chat displayed in a floating pop-out window"132

133 lightSrc="/images/codex/app/popover-light.webp"133 

134 darkSrc="/images/codex/app/popover-dark.webp"134> Illustration: ChatGPT desktop app chat displayed in a floating pop-out window

135 maxHeight="400px"

136 class="my-8"

137/>

Details

26 26 

27 27 

28 28 

29 <CodexScreenshot29

30 alt="Remote setup screen in the ChatGPT mobile app"30

31 lightSrc="/images/codex/app/mobile-setup-light.webp"31 

32 darkSrc="/images/codex/app/mobile-setup-dark.webp"32> Illustration: Remote setup screen in the ChatGPT mobile app

33 variant="no-wallpaper"33 

34 maxHeight="none"34 

35 maxWidth="420px"35

36 />

37 36 

38 37 

39 38 


102 101 

103</WorkflowSteps>102</WorkflowSteps>

104 103 

105<Illustration description="Connections controls for allowing devices to control this Mac and keeping it awake.">104 

106 <RemoteConnectionsIllustration105 

107 view="control-this-mac"106> Illustration: Connections controls for allowing devices to control this Mac and keeping it awake.

108 ariaLabel="Connections controls for allowing devices to control this Mac and keeping it awake."107 

109 />108 

110</Illustration>

111 109 

112## Choose what to connect110## Choose what to connect

113 111 


203Connections > Control other devices** to add the other host. A device can allow201Connections > Control other devices** to add the other host. A device can allow

204remote access and control another device at the same time.202remote access and control another device at the same time.

205 203 

206<Illustration description="Connections setup card for controlling another device from this Mac.">204 

207 <RemoteConnectionsIllustration205 

208 view="control-other-devices"206> Illustration: Connections setup card for controlling another device from this Mac.

209 ariaLabel="Connections setup card for controlling another device from this Mac."207 

210 />208 

211</Illustration>

212 209 

213## Connect to an SSH host210## Connect to an SSH host

214 211 


251 248 

252</WorkflowSteps>249</WorkflowSteps>

253 250 

254<Illustration description="Connections SSH list with three remote hosts.">251 

255 <RemoteConnectionsIllustration252 

256 view="ssh"253> Illustration: Connections SSH list with three remote hosts.

257 ariaLabel="Connections SSH list with three remote hosts."254 

258 />255 

259</Illustration>

260 256 

261<a id="hand-off-a-thread-between-hosts"></a>257<a id="hand-off-a-thread-between-hosts"></a>

262<a id="hand-off-a-chat-between-hosts"></a>258<a id="hand-off-a-chat-between-hosts"></a>

security/setup.md +28 −16

Details

27 27 

28 28 

29 29 

30 <img30

31 src={createEnvironment.src}31

32 alt="Codex environments"32 

33 class="block h-auto w-full"33> Illustration: Codex environments

34 />34 

35 

36

35 37 

36 38 

37 39 


59 61 

60 62 

61 63 

62 <img64

63 src={createScan.src}65

64 alt="Create a security scan"66 

65 class="block h-auto w-full"67> Illustration: Create a security scan

66 />68 

69 

70

67 71 

68 72 

69 73 


87 91 

88 92 

89 93 

90 <img94

91 src={reviewThreatModel.src}95

92 alt="Threat model editor in Codex Security"96 

93 class="block h-auto w-full"97> Illustration: Threat model editor in Codex Security

94 />98 

99 

100

95 101 

96 102 

97 103 


123- **Recommended Findings**: an evolving top 10 list of the most critical issues in the repo129- **Recommended Findings**: an evolving top 10 list of the most critical issues in the repo

124- **All Findings**: a sortable, filterable table of findings across the repository130- **All Findings**: a sortable, filterable table of findings across the repository

125 131 

126![Recommended findings view](https://learn.chatgpt.com/docs/security/images/aardvark_recommended_findings.png)132 

133

134 

135> Illustration: Recommended findings view

136 

137 

138 

127 139 

128Click a finding to open its detail page, which includes:140Click a finding to open its detail page, which includes:

129 141 

sites.md +5 −3

Details

146 146 

147</ContentModeSwitch>147</ContentModeSwitch>

148 148 

149<Illustration description="Interactive Sites analytics dashboard showing unique visitors and page views over seven days.">149 

150 <SitesAnalyticsIllustration />150 

151</Illustration>151> Illustration: Interactive Sites analytics dashboard showing unique visitors and page views over seven days.

152 

153 

152 154 

153Analytics is currently available for Sites that aren't owned by an Enterprise155Analytics is currently available for Sites that aren't owned by an Enterprise

154 workspace.156 workspace.

skills.md +7 −7

Details

22In the ChatGPT desktop app, open **Skills** in the sidebar to view and explore skills22In the ChatGPT desktop app, open **Skills** in the sidebar to view and explore skills

23created across your projects.23created across your projects.

24 24 

25<CodexScreenshot25 

26 alt="Skills picker showing available skills in the ChatGPT desktop app"26

27 lightSrc="/images/codex/app/skill-selector-light.webp"27 

28 darkSrc="/images/codex/app/skill-selector-dark.webp"28> Illustration: Skills picker showing available skills in the ChatGPT desktop app

29 maxHeight="400px"29 

30 class="my-8"30 

31/>31 

32 32 

33Skills use **progressive disclosure** to manage context efficiently. ChatGPT and33Skills use **progressive disclosure** to manage context efficiently. ChatGPT and

34Codex start with each skill's name and description, then load the full34Codex start with each skill's name and description, then load the full

subagents.md +11 −11

Details

242- Ask Codex directly to steer a running subagent, stop it, or close completed242- Ask Codex directly to steer a running subagent, stop it, or close completed

243 subagent threads.243 subagent threads.

244 244 

245<Illustration description="Codex desktop chat showing two subagents working in parallel.">245 

246 <SubagentWorkflowIllustration ariaLabel="Codex desktop chat showing two subagents working in parallel." />246 

247</Illustration>247> Illustration: Codex desktop chat showing two subagents working in parallel.

248 248 

249<Illustration description="Codex desktop Subagents panel with no active subagents and three completed audits.">249 

250 <SubagentWorkflowIllustration250 

251 ariaLabel="Codex desktop Subagents panel with no active subagents and three completed audits."251 

252 class="mt-4"252 

253 variant="results"253> Illustration: Codex desktop Subagents panel with no active subagents and three completed audits.

254 />254 

255</Illustration>255 

256 256 

257</ContentModeSwitch>257</ContentModeSwitch>

258 258 

use-chatgpt.md +10 −18

Details

50ChatGPT Work can plan a task, gather context, use tools, and carry the work50ChatGPT Work can plan a task, gather context, use tools, and carry the work

51through to a result you can review.51through to a result you can review.

52 52 

53<Illustration description="ChatGPT Work comparing vendors and producing a spreadsheet you can review.">53 

54 <CodexScreenshot54 

55 alt="ChatGPT Work comparing vendors in a spreadsheet"55> Illustration: ChatGPT Work comparing vendors and producing a spreadsheet you can review.

56 lightSrc="/codex/get-started-with-work/comparison-spreadsheet.webp"56 

57 darkSrc="/codex/get-started-with-work/comparison-spreadsheet.webp"57 

58 maxHeight={520}

59 class="my-6 p-4 md:p-8"

60 />

61</Illustration>

62 58 

63Ask it to:59Ask it to:

64 60 


208on information outside the chat, actions in another system, or a204on information outside the chat, actions in another system, or a

209repeatable workflow.205repeatable workflow.

210 206 

211<Illustration description="ChatGPT plugin directory showing connected tools such as Google Drive, Slack, and SharePoint.">207 

212 <CodexScreenshot208 

213 alt="ChatGPT plugin directory showing connected work tools"209> Illustration: ChatGPT plugin directory showing connected tools such as Google Drive, Slack, and SharePoint.

214 lightSrc="/codex/get-started-with-work/plugins.webp"210 

215 darkSrc="/codex/get-started-with-work/plugins.webp"211 

216 maxHeight={520}

217 class="my-6 p-4 md:p-8"

218 />

219</Illustration>

220 212 

221Plugin availability depends on your plan, workspace settings, and the plugin213Plugin availability depends on your plan, workspace settings, and the plugin

222itself. Learn more about [skills and plugins](https://learn.chatgpt.com/docs/skills-and-plugins).214itself. Learn more about [skills and plugins](https://learn.chatgpt.com/docs/skills-and-plugins).

Details

89Use their controls to see how a focused prompt can become an interactive89Use their controls to see how a focused prompt can become an interactive

90explanation, lab, or teaching tool.90explanation, lab, or teaching tool.

91 91 

92<Illustration description="Three interactive ChatGPT visualization examples: a spirograph with adjustable geometry, a wave interference lab with a movable probe, and a tokenizer explainer with editable text and tokenization steps.">92 

93 <VisualizationExampleGallery client:visible />93 

94</Illustration>94> Illustration: Three interactive ChatGPT visualization examples: a spirograph with adjustable geometry, a wave interference lab with a movable probe, and a tokenizer explainer with editable text and tokenization steps.

95 

96 

95 97 

96## Refine and continue98## Refine and continue

97 99 

whats-new.md +35 −35

Details

554Browser use is also up to twice as fast because CDP and DOM snapshot554Browser use is also up to twice as fast because CDP and DOM snapshot

555optimizations reduce browser round trips.555optimizations reduce browser round trips.

556 556 

557<CodexScreenshot557 

558 alt="Codex Browser settings with Developer mode enabled"558

559 lightSrc="/images/codex/app/browser-developer-mode-light.webp"559 

560 darkSrc="/images/codex/app/browser-developer-mode-dark.webp"560> Illustration: Codex Browser settings with Developer mode enabled

561 maxHeight="420px"561 

562 variant="no-wallpaper"562 

563/>563 

564 564 

565 565 

566 566 


755operate macOS apps. Together, they made visual implementation and end-to-end755operate macOS apps. Together, they made visual implementation and end-to-end

756verification part of the same task as the code change.756verification part of the same task as the code change.

757 757 

758<CodexScreenshot758 

759 alt="ChatGPT desktop app with a local web page open in the built-in browser"759

760 lightSrc="/images/codex/app/in-app-browser-light.webp"760 

761 darkSrc="/images/codex/app/in-app-browser-dark.webp"761> Illustration: ChatGPT desktop app with a local web page open in the built-in browser

762 maxHeight="420px"762 

763 variant="no-wallpaper"763 

764/>764 

765 765 

766<a id="start-with-a-task-and-keep-it-moving"></a>766<a id="start-with-a-task-and-keep-it-moving"></a>

767 767 


823tasks faster to configure, and custom themes made the workspace easier to823tasks faster to configure, and custom themes made the workspace easier to

824personalize.824personalize.

825 825 

826<CodexScreenshot826 

827 alt="Scheduled task settings in the ChatGPT desktop app"827

828 lightSrc="/images/codex/app/codex-automations-light.webp"828 

829 darkSrc="/images/codex/app/codex-automations-dark.webp"829> Illustration: Scheduled task settings in the ChatGPT desktop app

830 maxHeight="420px"830 

831 variant="no-wallpaper"831 

832/>832 

833 833 

834### Let Codex inspect terminal output834### Let Codex inspect terminal output

835 835 


856and sandbox support, plus worktrees, scheduled tasks, and skills. WSL remained856and sandbox support, plus worktrees, scheduled tasks, and skills. WSL remained

857available for developers who preferred a Linux environment.857available for developers who preferred a Linux environment.

858 858 

859<CodexScreenshot859 

860 alt="Codex app running natively on Windows"860

861 lightSrc="/images/codex/windows/codex-windows-light.webp"861 

862 darkSrc="/images/codex/windows/codex-windows-dark.webp"862> Illustration: Codex app running natively on Windows

863 maxHeight="420px"863 

864 variant="no-wallpaper"864 

865/>865 

866 866 

867<a id="move-tasks-between-local-and-worktree"></a>867<a id="move-tasks-between-local-and-worktree"></a>

868 868 


898built-in Git review, worktrees, skills, scheduled tasks, and voice dictation.898built-in Git review, worktrees, skills, scheduled tasks, and voice dictation.

899Those capabilities now live in Codex in the [ChatGPT desktop app](https://learn.chatgpt.com/docs/app).899Those capabilities now live in Codex in the [ChatGPT desktop app](https://learn.chatgpt.com/docs/app).

900 900 

901<CodexScreenshot901 

902 alt="The original Codex app showing parallel project chats on macOS"902

903 lightSrc="/images/codex/app/codex-app-basic-light.webp"903 

904 darkSrc="/images/codex/app/codex-app-basic-dark.webp"904> Illustration: The original Codex app showing parallel project chats on macOS

905 maxHeight="420px"905 

906 variant="no-wallpaper"906 

907/>907 

908 908 

909### Steer active work and add files909### Steer active work and add files

910 910 

windows.md +7 −7

Details

13requiring WSL or a virtual machine. This keeps Codex in Windows-native13requiring WSL or a virtual machine. This keeps Codex in Windows-native

14workflows while enforcing bounded filesystem and network permissions.14workflows while enforcing bounded filesystem and network permissions.

15 15 

16<CodexScreenshot16 

17 alt="ChatGPT desktop app Windows sandbox setup prompt above the message composer"17

18 lightSrc="/images/codex/windows/windows-sandbox-setup.webp"18 

19 darkSrc="/images/codex/windows/windows-sandbox-setup.webp"19> Illustration: ChatGPT desktop app Windows sandbox setup prompt above the message composer

20 maxHeight="400px"20 

21 class="my-8"21 

22/>22 

23 23 

24 24 

25 25 

Details

10[Windows sandbox](https://learn.chatgpt.com/docs/windows/windows-sandbox#windows-sandbox), or you can configure it to10[Windows sandbox](https://learn.chatgpt.com/docs/windows/windows-sandbox#windows-sandbox), or you can configure it to

11run in [Windows Subsystem for Linux 2 (WSL2)](#windows-subsystem-for-linux-wsl).11run in [Windows Subsystem for Linux 2 (WSL2)](#windows-subsystem-for-linux-wsl).

12 12 

13<CodexScreenshot13 

14 alt="ChatGPT desktop app for Windows showing a project sidebar, active chat, and review pane"14

15 lightSrc="/images/codex/windows/codex-windows-light.webp"15 

16 darkSrc="/images/codex/windows/codex-windows-dark.webp"16> Illustration: ChatGPT desktop app for Windows showing a project sidebar, active chat, and review pane

17 variant="no-wallpaper"17 

18 maxHeight="320px"18 

19/>19 

20 20 

21## Download the ChatGPT desktop app21## Download the ChatGPT desktop app

22 22 


63 63 

64 64 

65 65 

66<CodexScreenshot66 

67 alt="ChatGPT desktop app settings showing the default Open In app on Windows"67

68 lightSrc="/images/codex/windows/open-in-windows-light.webp"68 

69 darkSrc="/images/codex/windows/open-in-windows-dark.webp"69> Illustration: ChatGPT desktop app settings showing the default Open In app on Windows

70 maxHeight={520}70 

71 maxWidth={784}71 

72/>72 

73 73 

74</section>74</section>

75 75 


95 95 

96 96 

97 97 

98<CodexScreenshot98 

99 alt="ChatGPT desktop app settings showing the integrated terminal selection on Windows"99

100 lightSrc="/images/codex/windows/integrated-shell-light.webp"100 

101 darkSrc="/images/codex/windows/integrated-shell-dark.webp"101> Illustration: ChatGPT desktop app settings showing the integrated terminal selection on Windows

102 maxHeight={520}102 

103 maxWidth={788}103 

104/>104 

105 105 

106</section>106</section>

107 107 


129WSL1 was supported through Codex `0.114`. Starting in Codex `0.115`, the Linux129WSL1 was supported through Codex `0.114`. Starting in Codex `0.115`, the Linux

130sandbox moved to `bubblewrap`, so WSL1 is no longer supported.130sandbox moved to `bubblewrap`, so WSL1 is no longer supported.

131 131 

132<CodexScreenshot132 

133 alt="ChatGPT desktop app settings showing the agent selector with Windows native and WSL options"133

134 lightSrc="/images/codex/windows/wsl-select-light.webp"134 

135 darkSrc="/images/codex/windows/wsl-select-dark.webp"135> Illustration: ChatGPT desktop app settings showing the agent selector with Windows native and WSL options

136 maxHeight={520}136 

137 maxWidth={786}137 

138 class="mb-8"138 

139/>

140 139 

141You configure the integrated terminal independently from the agent. See140You configure the integrated terminal independently from the agent. See

142[Customize for your dev setup](#customize-for-your-dev-setup) for the141[Customize for your dev setup](#customize-for-your-dev-setup) for the

workflows.md +11 −11

Details

187 187 

188## Use voice dictation188## Use voice dictation

189 189 

190In the ChatGPT desktop app, hold <kbd>Ctrl</kbd>+<kbd>M</kbd> while the composer is190In the ChatGPT desktop app, press <kbd>Ctrl+Shift+D</kbd> while the composer is

191visible, then start talking. ChatGPT transcribes your speech into the composer so191visible, then start talking. ChatGPT transcribes your speech into the composer

192you can review and edit it before sending the prompt.192so you can review and edit it before sending the prompt.

193 193 

194<CodexScreenshot194 

195 alt="Voice dictation indicator in the composer with a transcribed prompt"195

196 lightSrc="/images/codex/app/voice-dictation-light.webp"196 

197 darkSrc="/images/codex/app/voice-dictation-dark.webp"197> Illustration: Voice dictation indicator in the composer with a transcribed prompt

198 maxHeight="400px"198 

199 class="my-8"199 

200/>200 

201 201 

202<a id="threads"></a>202<a id="threads"></a>

203<a id="chats"></a>203<a id="chats"></a>