For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Primary navigation

Suggested

Workflows

Capabilities

Reference

API Dashboard
Try ChatGPT

Commands

Reference for commands and keyboard shortcuts in the ChatGPT desktop app

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.

Action Shortcut
General
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
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
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
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) ⌘ + ⌘

To find, customize, or reset app shortcuts, open Settings > Keyboard 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.

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.

Use these canonical forms when you create links. The sections below list the full reference by link type.

Deep linkOpens
codex://threads/newA new local chat.
codex://new?<query>A new local chat with at least one query parameter.
codex://threads/<thread-id>A local chat. <thread-id> is its technical thread ID.
codex://settingsSettings.
codex://settings/connections/<connection-type>Computer, device, or SSH connection settings.
codex://settings/connections/ssh/add?name=<ssh-config-host>Adds a host from your SSH config to Codex.
codex://skillsSkills.
codex://automationsScheduled with the create flow open.
codex://plugins/install/<plugin-name>?marketplace=<marketplace-name>The install flow for a plugin from a known marketplace.
codex://plugins/<plugin-id>A plugin detail page.
codex://plugins/<plugin-name>?marketplacePath=<absolute-marketplace-path>A local plugin detail page from a local marketplace.
codex://pets/install?name=<pet-name>&imageUrl=<https-image-url>The pet install flow.

Chats

Use these links when you need to open an existing local chat or start a new one.

Deep linkOpens
codex://threads/<thread-id>A local chat. <thread-id> is its technical thread ID.
codex://threads/newA new local chat.
codex://threads/new?<query>A new local chat with optional query parameters.
codex://new?<query>A new local chat. Include at least one of prompt, path, or originUrl; otherwise the link does nothing.

For codex://threads/new or codex://new, add any of these query parameters as needed; you can combine them in the same URL.

Query parameterRequiredWhat it does
prompt=<text>NoSets the initial composer text.
path=<absolute-path>NoOpens the new chat in a local workspace. path must be an absolute path to a local directory. When valid, Codex uses that directory as the active workspace.
originUrl=<git-remote-url>NoMatches one of your current workspace roots by Git remote URL. If path is also present, Codex resolves path first.

Example: Show me some fun stats about how I’ve been using Codex

Start a chat with a plugin

To help users start a plugin-backed chat, include a plugin mention in the prompt before you encode it:

[@Example](plugin://example@openai-curated) Summarize this document: https://example.com/document/123

Encode the complete prompt as a URI component—for example, with encodeURIComponent in JavaScript—and pass it to the prompt parameter:

codex://new?prompt=%5B%40Example%5D(plugin%3A%2F%2Fexample%40openai-curated)%20Summarize%20this%20document%3A%20https%3A%2F%2Fexample.com%2Fdocument%2F123

The link opens a new chat with the decoded prompt in the composer. It doesn’t send the prompt automatically. After the user sends it, Codex can use an installed plugin in that chat. If the plugin isn’t installed but is available to the user, Codex asks the user to install it and connect any required connectors. After setup, the user can select Continue to resume the same chat. Workspace settings can limit which plugins a user can install. For plugin installation and permission details, see Plugins.

Settings

Use these links when you need to open Settings or a specific settings page.

Deep linkOpens
codex://settingsSettings.
codex://settings/browser-useBrowser settings.
codex://settings/computer-use/google-chromeGoogle Chrome settings for computer use.
codex://settings/connectionsRemote connections settings.
codex://settings/connections/computerSettings for controlling this Mac or PC from another device.
codex://settings/connections/devicesSettings for controlling other devices.
codex://settings/connections/sshSSH connection settings.
codex://settings/connections/ssh/add?name=<ssh-config-host>Adds the named host alias as a Codex-managed connection, then opens SSH connection settings.

The name value must match a host alias in ~/.ssh/config. The link disables automatic connection for the added host. If Codex can’t find the named host, it opens SSH connection settings and shows an error.

Unsupported codex://settings/... paths open the main Settings page.

Skills

Use these links when you need to open Skills.

Deep linkOpens
codex://skillsSkills.

Scheduled

Use these links when you need to open Scheduled.

Deep linkOpens
codex://automationsScheduled with the create flow open.

Plugins

Plugin links use different forms depending on whether you are installing from a marketplace, opening a plugin, or working from a local marketplace.json. For plugin basics, see Plugins. For local or repo marketplace setup, see Build plugins.

Plugin install

Use this form to open the install flow for a plugin from a marketplace that Codex already knows about.

Deep linkOpens
codex://plugins/install/<plugin-name>?marketplace=<marketplace-name>The plugin detail or install flow for a plugin.
Query parameterRequiredWhat it does
marketplace=<marketplace-name>YesIdentifies the marketplace. For an OpenAI-curated plugin, use openai-curated.

The install link accepts only the marketplace query parameter. If Codex can’t find the requested marketplace or plugin, it opens the Plugins page instead.

Plugin detail

Deep linkOpens
codex://plugins/<plugin-id>A plugin detail page.

<plugin-id> must identify the plugin. For an OpenAI-curated plugin, use the form <plugin-name>@openai-curated.

Codex-generated plugin links can also include these query parameters. Omit both when you write a link manually.

Query parameterRequiredWhat it does
hostId=<host-id>NoIdentifies the Codex host that owns the plugin context, such as local or one of your configured remote connections. Codex provides these IDs.
source=manageNoPreserves the app’s plugin-management entry point. It’s not admin-only.

Example: Open the OpenAI Developers plugin

Local plugin

For local or repo marketplace setup, see Build plugins.

Deep linkOpens
codex://plugins/<plugin-name>?marketplacePath=<absolute-marketplace-path>A local plugin detail page from a local marketplace.
Query parameterRequiredWhat it does
marketplacePath=<absolute-marketplace-path>YesAbsolute path to the local marketplace.json, for example /Users/alex/.agents/plugins/marketplace.json.
mode=shareNoOpens the share flow for that local plugin.

Pets

Use these links to open the pet install flow when that feature is enabled.

Deep linkOpens
codex://pets/install?name=<pet-name>&imageUrl=<https-image-url>The pet install flow.
Query parameterRequiredWhat it does
name=<pet-name>YesSets the pet name. The value must contain at least one non-whitespace character.
imageUrl=<https-image-url>YesProvides an absolute HTTPS URL for the pet image or sprite sheet.
description=<text>NoAdds a description to the install flow.
spriteVersionNumber=<1-or-2>NoSelects the sprite-sheet format. The default is 1; the only other supported value is 2.

The install link accepts only these query parameters. Invalid names, non-HTTPS image URLs, unsupported sprite versions, or extra path segments cause the link to do nothing.

See also