Commands
For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending
.mdto the page URL.
Use these commands and keyboard shortcuts to navigate the app.
Keyboard shortcuts
Choose your platform to see its default shortcuts. Some shortcuts appear only when the corresponding feature or view is available.
macOS
| General | Shortcut |
|---|---|
| Open command menu | ⌘+⇧+P or ⌘+K |
| Open settings | ⌘+, |
| Open keyboard shortcuts | ⌘+/ |
| Open folder (Codex and Work only) | ⌘+O |
| Navigate back | ⌘+[ or Mouse Back |
| Navigate forward | ⌘+] or Mouse Forward |
| Increase font size | ⌘++ or ⌘+Numpad + |
| Decrease font size | ⌘+- or ⌘+Numpad − |
| Reset font size | ⌘+0 or ⌘+Numpad 0 |
| Toggle sidebar | ⌘+B |
| Toggle bottom panel (Codex only) | ⌘+J |
| Toggle terminal (Codex only) | ⌃+` |
| Clear terminal (When the terminal is focused) | ⌃+L or ⌘+K |
| Clear all unread indicators (Codex only) | ⇧+Esc |
| Undo last app action | ⌘+Z |
| Redo last app action | ⌘+⇧+Z |
| Close current tab or window | ⌘+W |
| Toggle full screen | ⌘+⌃+F |
| Quit the app | ⌘+Q |
| Chats | Shortcut |
|---|---|
| New chat | ⌘+N or ⌘+⇧+O |
| New standalone chat (Codex only) | ⌘+⌥+O |
| Quick chat (ChatGPT only) | ⌘+⌥+N |
| New temporary chat (ChatGPT only) | ⌘+⇧+N |
| Archive chat | ⌘+⇧+A |
| Mark chat as unread | ⌘+⇧+U |
| Pin or unpin chat | ⌘+⌥+P |
| Rename chat | ⌘+⌥+R |
| Open side chat (Codex only) | ⌘+⌥+S |
| Search chats (Assign one in Settings > Keyboard Shortcuts) | Not assigned by default |
| Find in chat | ⌘+F |
| Find next match | ⌘+G |
| Find previous match | ⌘+⇧+G |
| Previous chat or tab | ⌃+⇧+Tab or ⌘+⇧+[ or ⌘+⌥+← |
| Next chat or tab | ⌃+Tab or ⌘+⇧+] or ⌘+⌥+→ |
| Next chat needing attention (Codex only) | ⌘+⌥+A |
| Open recent chat 1–6 | ⌘+⌥+1–6 |
| Go to chat 1–9 | ⌘+1–9 |
| Input and modes | Shortcut |
|---|---|
| Open model picker | ⌃+⇧+M |
| Open project picker | ⌘+⌥+⇧+O |
| Start voice chat (When voice chat is available) | ⌃+⇧+V |
| Start dictation (When dictation is available) | ⌃+⇧+D |
| Restore previous composer prompt (When the composer is empty) | ↑ |
| Approve request (When an approval request is open) | ⏎ |
| Decline request (When an approval request is open) | Esc |
| Switch to Chat, Work, or Codex (In the order shown) | ⌃+1 or ⌃+2 or ⌃+3 |
| Toggle Activity view (When Activity is available) | ⌘+⌥+U |
| Workspace and browser | Shortcut |
|---|---|
| Run environment action 1 (When the environment defines a primary action) | ⌘+⇧+D |
| Search files (Codex only) | ⌘+P |
| Toggle file tree (Codex only) | ⌘+⇧+E |
| Open review tab (Codex only) | ⌃+⇧+G |
| Toggle review panel (Codex only) | ⌘+⌥+B |
| Open browser tab (When the built-in browser is available) | ⌘+T |
| Toggle browser panel (When the built-in browser is available) | ⌘+⇧+B |
| Go to line or focus browser address bar (Depends on the focused view) | ⌘+L |
| Browser back (When the built-in browser is focused) | ⌘+← |
| Browser forward (When the built-in browser is focused) | ⌘+→ |
| Reload browser page (When the built-in browser is focused) | ⌘+R |
| Reload browser page without cache (When the built-in browser is focused) | ⌘+⇧+R |
| Copy browser URL (When the built-in browser is focused) | ⌘+⇧+C |
| Toggle browser browse or comment mode (When browser commenting is available) | ⌘+. |
| Copy conversation path (Codex only) | ⌘+⌥+⇧+C |
| Copy chat deep link | ⌘+⌥+L |
| Copy session ID | ⌘+⌥+C |
| Copy working directory (Codex only) | ⌘+⇧+C |
| Take an Appshot (press both keys simultaneously) | ⌘+⌘ |
Windows
| General | Shortcut |
|---|---|
| Open command menu | Ctrl+Shift+P or Ctrl+K |
| Open settings | Ctrl+, |
| Open keyboard shortcuts | Ctrl+/ |
| Open folder (Codex and Work only) | Ctrl+O |
| Navigate back | Ctrl+[ or Mouse Back |
| Navigate forward | Ctrl+] or Mouse Forward |
| Increase font size | Ctrl++ or Ctrl+= or Ctrl+Numpad + |
| Decrease font size | Ctrl+- or Ctrl+Numpad − |
| Reset font size | Ctrl+0 or Ctrl+Numpad 0 |
| Toggle sidebar | Ctrl+B |
| Toggle bottom panel (Codex only) | Ctrl+J |
| Toggle terminal (Codex only) | Ctrl+` |
| Clear terminal (When the terminal is focused) | Ctrl+L or Ctrl+K |
| Clear all unread indicators (Codex only) | Shift+Esc |
| Undo last app action | Ctrl+Z |
| Redo last app action | Ctrl+Y or Ctrl+Shift+Z |
| Close current tab or window | Ctrl+W or Ctrl+F4 |
| Toggle full screen | F11 |
| Quit the app | Ctrl+Q |
| Chats | Shortcut |
|---|---|
| New chat | Ctrl+N or Ctrl+Shift+O |
| New standalone chat (Codex only) | Ctrl+Alt+O |
| Quick chat (ChatGPT only) | Ctrl+Alt+N |
| New temporary chat (ChatGPT only) | Ctrl+Shift+N |
| Archive chat | Ctrl+Shift+A |
| Mark chat as unread | Ctrl+Shift+U |
| Pin or unpin chat | Ctrl+Alt+P |
| Rename chat | Ctrl+Alt+R |
| Open side chat (Codex only) | Ctrl+Alt+S |
| Search chats (Assign one in Settings > Keyboard Shortcuts) | Not assigned by default |
| Find in chat | Ctrl+F |
| Find next match | Ctrl+G |
| Find previous match | Shift+F3 |
| Previous chat or tab | Ctrl+Shift+Tab or Ctrl+Shift+[ or Ctrl+Page Up |
| Next chat or tab | Ctrl+Tab or Ctrl+Shift+] or Ctrl+Page Down |
| Next chat needing attention (Codex only) | Ctrl+Alt+A |
| Open recent chat 1–6 | Ctrl+Alt+1–6 |
| Go to chat 1–9 | Ctrl+1–9 |
| Input and modes | Shortcut |
|---|---|
| Open model picker | Ctrl+Shift+M |
| Open project picker | Ctrl+Alt+Shift+O |
| Start voice chat (When voice chat is available) | Ctrl+Shift+V |
| Start dictation (When dictation is available) | Ctrl+Shift+D |
| Restore previous composer prompt (When the composer is empty) | ↑ |
| Approve request (When an approval request is open) | ⏎ |
| Decline request (When an approval request is open) | Esc |
| Switch to Chat, Work, or Codex (In the order shown) | Alt+1 or Alt+2 or Alt+3 |
| Toggle Activity view (When Activity is available) | Ctrl+Alt+U |
| Workspace and browser | Shortcut |
|---|---|
| Run environment action 1 (When the environment defines a primary action) | Win+Shift+D |
| Search files (Codex only) | Ctrl+P |
| Toggle file tree (Codex only) | Ctrl+Shift+E |
| Open review tab (Codex only) | Ctrl+Shift+G |
| Toggle review panel (Codex only) | Ctrl+Alt+B |
| Open browser tab (When the built-in browser is available) | Ctrl+T |
| Toggle browser panel (When the built-in browser is available) | Ctrl+Shift+B |
| Go to line or focus browser address bar (Depends on the focused view) | Ctrl+L |
| Browser back (When the built-in browser is focused) | Alt+← |
| Browser forward (When the built-in browser is focused) | Alt+→ |
| Reload browser page (When the built-in browser is focused) | Ctrl+R |
| Reload browser page without cache (When the built-in browser is focused) | Ctrl+Shift+R |
| Copy browser URL (When the built-in browser is focused) | Ctrl+Shift+C |
| Toggle browser browse or comment mode (When browser commenting is available) | Ctrl+. |
| Copy chat deep link | Ctrl+Alt+L |
| Copy session ID | Ctrl+Alt+C |
| Copy working directory (Codex only) | Ctrl+Shift+C |
Linux
| General | Shortcut |
|---|---|
| Open command menu | Ctrl+Shift+P or Ctrl+K |
| Open settings | Ctrl+, |
| Open keyboard shortcuts | Ctrl+/ |
| Open folder (Codex and Work only) | Ctrl+O |
| Navigate back | Ctrl+[ or Mouse Back |
| Navigate forward | Ctrl+] or Mouse Forward |
| Increase font size | Ctrl++ or Ctrl+= or Ctrl+Numpad + |
| Decrease font size | Ctrl+- or Ctrl+Numpad − |
| Reset font size | Ctrl+0 or Ctrl+Numpad 0 |
| Toggle sidebar | Ctrl+B |
| Toggle bottom panel (Codex only) | Ctrl+J |
| Toggle terminal (Codex only) | Ctrl+` |
| Clear terminal (When the terminal is focused) | Ctrl+L or Ctrl+K |
| Clear all unread indicators (Codex only) | Shift+Esc |
| Undo last app action | Ctrl+Z |
| Redo last app action | Ctrl+Y or Ctrl+Shift+Z |
| Close current tab or window | Ctrl+W or Ctrl+F4 |
| Toggle full screen | F11 |
| Quit the app | Ctrl+Q |
| Chats | Shortcut |
|---|---|
| New chat | Ctrl+N or Ctrl+Shift+O |
| New standalone chat (Codex only) | Ctrl+Alt+O |
| Quick chat (ChatGPT only) | Ctrl+Alt+N |
| New temporary chat (ChatGPT only) | Ctrl+Shift+N |
| Archive chat | Ctrl+Shift+A |
| Mark chat as unread | Ctrl+Shift+U |
| Pin or unpin chat | Ctrl+Alt+P |
| Rename chat | Ctrl+Alt+R |
| Open side chat (Codex only) | Ctrl+Alt+S |
| Search chats (Assign one in Settings > Keyboard Shortcuts) | Not assigned by default |
| Find in chat | Ctrl+F |
| Find next match | Ctrl+G |
| Find previous match | Shift+F3 |
| Previous chat or tab | Ctrl+Shift+Tab or Ctrl+Shift+[ or Ctrl+Page Up |
| Next chat or tab | Ctrl+Tab or Ctrl+Shift+] or Ctrl+Page Down |
| Next chat needing attention (Codex only) | Ctrl+Alt+A |
| Open recent chat 1–6 | Ctrl+Alt+1–6 |
| Go to chat 1–9 | Ctrl+1–9 |
| Input and modes | Shortcut |
|---|---|
| Open model picker | Ctrl+Shift+M |
| Open project picker | Ctrl+Alt+Shift+O |
| Start voice chat (When voice chat is available) | Ctrl+Shift+V |
| Start dictation (When dictation is available) | Ctrl+Shift+D |
| Restore previous composer prompt (When the composer is empty) | ↑ |
| Approve request (When an approval request is open) | ⏎ |
| Decline request (When an approval request is open) | Esc |
| Switch to Chat, Work, or Codex (In the order shown) | Alt+1 or Alt+2 or Alt+3 |
| Toggle Activity view (When Activity is available) | Ctrl+Alt+U |
| Workspace and browser | Shortcut |
|---|---|
| Run environment action 1 (When the environment defines a primary action) | Super+Shift+D |
| Search files (Codex only) | Ctrl+P |
| Toggle file tree (Codex only) | Ctrl+Shift+E |
| Open review tab (Codex only) | Ctrl+Shift+G |
| Toggle review panel (Codex only) | Ctrl+Alt+B |
| Open browser tab (When the built-in browser is available) | Ctrl+T |
| Toggle browser panel (When the built-in browser is available) | Ctrl+Shift+B |
| Go to line or focus browser address bar (Depends on the focused view) | Ctrl+L |
| Browser back (When the built-in browser is focused) | Alt+← |
| Browser forward (When the built-in browser is focused) | Alt+→ |
| Reload browser page (When the built-in browser is focused) | Ctrl+R |
| Reload browser page without cache (When the built-in browser is focused) | Ctrl+Shift+R |
| Copy browser URL (When the built-in browser is focused) | Ctrl+Shift+C |
| Toggle browser browse or comment mode (When browser commenting is available) | Ctrl+. |
| Copy chat deep link | Ctrl+Alt+L |
| Copy session ID | Ctrl+Alt+C |
| Copy working directory (Codex only) | Ctrl+Shift+C |
| Shortcuts**. |
You can search by command name or switch the search field into keystroke mode and press the shortcut you want to find. Appshots use a separate global shortcut under Settings > Appshots.
On Linux, experimental native Wayland can affect shortcut support. See the Linux desktop app guide.
Search past chats and find in a chat
Use Search chats to reopen a past chat. Search chats doesn't have a default shortcut. You can assign one under Settings > Keyboard Shortcuts. When expanded matching is available, search can also match chat content and Git branch names, so you can search for a phrase from the chat or a branch such as fix/login-redirect.
Use Find in chat after opening a chat to find text within it. It doesn't search across other chats.
For actions that start with /, see Slash commands.
Deep links
The ChatGPT desktop app keeps the codex:// URL scheme for compatibility, so links can open specific parts of the app directly. Encode query string values before adding them to a URL.
Supported links
Use these canonical forms when you create links. The sections below list the full reference by link type.
| Deep link | Opens |
|---|---|
codex://threads/new | A new local chat. |
codex://new?<query> | A new local chat with at least one query parameter. |