Documentation — Spybara

administration.md +0 −7

Details

84 href: "/codex/auth",84 href: "/codex/auth",

85 icon: "key",85 icon: "key",

86 },86 },

~~87 {~~

~~88 title: "Workload identity",~~

~~89 description:~~

~~90 "Let trusted workloads use Codex without long-lived credentials.",~~

~~91 href: "/codex/enterprise/workload-identity",~~

~~92 icon: "key",~~

~~93 },~~

94 {87 {

95 title: "Personal Access Tokens",88 title: "Personal Access Tokens",

96 description: "Create and manage tokens for programmatic access.",89 description: "Create and manage tokens for programmatic access.",

agent-configuration/speed.md +0 −9

Details

36 src="/videos/codex/fast-mode-demo.mp4"36 src="/videos/codex/fast-mode-demo.mp4"

37 class="[&_video]:mx-auto [&_video]:max-h-[400px] [&_video]:max-w-full [&_video]:w-auto"37 class="[&_video]:mx-auto [&_video]:max-h-[400px] [&_video]:max-w-full [&_video]:w-auto"

38/>38/>

~~40## Codex-Spark~~

~~42GPT-5.3-Codex-Spark is a separate fast, less-capable Codex model optimized for~~

~~43near-instant, real-time coding iteration. Unlike fast mode, which speeds up a~~

~~44supported model at a higher credit rate, Codex-Spark is its own model choice~~

~~45and has its own usage limits.~~

~~47During research preview Codex-Spark is only available for ChatGPT Pro subscribers.~~

agent-configuration/subagents.md +2 −2

Details

420```toml420```toml

421name = "pr_explorer"421name = "pr_explorer"

422description = "Read-only codebase explorer for gathering evidence before changes are proposed."422description = "Read-only codebase explorer for gathering evidence before changes are proposed."

423model = "gpt-5.3-codex-spark"423model = "gpt-5.6-luna"

424model_reasoning_effort = "medium"424model_reasoning_effort = "medium"

425sandbox_mode = "read-only"425sandbox_mode = "read-only"

426developer_instructions = """426developer_instructions = """

518```toml518```toml

519name = "ui_fixer"519name = "ui_fixer"

520description = "Implementation-focused agent for small, targeted fixes after the issue is understood."520description = "Implementation-focused agent for small, targeted fixes after the issue is understood."

521model = "gpt-5.3-codex-spark"521model = "gpt-5.6-luna"

522model_reasoning_effort = "medium"522model_reasoning_effort = "medium"

523developer_instructions = """523developer_instructions = """

524Own the fix once the issue is reproduced.524Own the fix once the issue is reproduced.

app/commands.md +0 −455 deleted

File Deleted View Diff

~~1# Commands~~

~~3> For the complete documentation index, see [llms.txt](https://learn.chatgpt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to the page URL.~~

~~5Use these commands and keyboard shortcuts to navigate the app.~~

~~7## Keyboard shortcuts~~

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

~~11### macOS~~

~~15| General | Shortcut |~~

~~16| --- | --- |~~

~~17| Open command menu | **⌘+⇧+P** or **⌘+K** |~~

~~18| Open settings | **⌘+,** |~~

~~19| Open keyboard shortcuts | **⌘+/** |~~

~~20| Open folder (Codex and Work only) | **⌘+O** |~~

~~21| Navigate back | **⌘+[** or **Mouse Back** |~~

~~22| Navigate forward | **⌘+]** or **Mouse Forward** |~~

~~23| Increase font size | **⌘++** or **⌘+Numpad +** |~~

~~24| Decrease font size | **⌘+-** or **⌘+Numpad −** |~~

~~25| Reset font size | **⌘+0** or **⌘+Numpad 0** |~~

~~26| Toggle sidebar | **⌘+B** |~~

~~27| Toggle bottom panel (Codex only) | **⌘+J** |~~

~~28| Toggle terminal (Codex only) | **⌃+`** |~~

~~29| Clear terminal (When the terminal is focused) | **⌃+L** or **⌘+K** |~~

~~30| Clear all unread indicators (Codex only) | **⇧+Esc** |~~

~~31| Undo last app action | **⌘+Z** |~~

~~32| Redo last app action | **⌘+⇧+Z** |~~

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

~~34| Toggle full screen | **⌘+⌃+F** |~~

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

~~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** |~~

~~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** |~~

~~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) | **⌘+⌘** |~~

~~92### Windows~~

~~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~~

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

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).

~~257~~

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

~~259~~

260## Search past chats and find in a chat

~~261~~

262Use **Search chats** to reopen a past chat. Search chats doesn't have a default

263shortcut. You can assign one under **Settings > Keyboard Shortcuts**. When

264expanded matching is available, search can also match chat content and Git

265branch names, so you can search for a phrase from the chat or a branch such as

266`fix/login-redirect`.

~~267~~

268Use **Find in chat** after opening a chat to find text within it. It doesn't

269search across other chats.

~~270~~

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

~~272~~

273## Deep links

~~274~~

275The ChatGPT desktop app keeps the `codex://` URL scheme for compatibility, so

276links can open specific parts of the app directly. Encode query string values

277before adding them to a URL.

~~278~~

279### Supported links

~~280~~

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

~~282~~

283| Deep link | Opens |

284| --------------------------------------------------------------------------- | ------------------------------------------------------- |

285| `codex://threads/new` | A new local chat. |

286| `codex://new?<query>` | A new local chat with at least one query parameter. |

287| `codex://threads/<thread-id>` | A local chat. `<thread-id>` is its technical thread ID. |

288| `codex://settings` | Settings. |

289| `codex://settings/connections/<connection-type>` | Computer, device, or SSH connection settings. |

290| `codex://settings/connections/ssh/add?name=<ssh-config-host>` | Adds a host from your SSH config to Codex. |

291| `codex://skills` | Skills. |

292| `codex://automations` | Scheduled with the create flow open. |

293| `codex://plugins/install/<plugin-name>?marketplace=<marketplace-name>` | The install flow for a plugin from a known marketplace. |

294| `codex://plugins/<plugin-id>` | A plugin detail page. |

295| `codex://plugins/<plugin-name>?marketplacePath=<absolute-marketplace-path>` | A local plugin detail page from a local marketplace. |

296| `codex://pets/install?name=<pet-name>&imageUrl=<https-image-url>` | The pet install flow. |

~~297~~

298<a id="tasks"></a>

~~299~~

300### Chats

~~301~~

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

~~303~~

304| Deep link | Opens |

305| ----------------------------- | ------------------------------------------------------------------------------------------------------------ |

306| `codex://threads/<thread-id>` | A local chat. `<thread-id>` is its technical thread ID. |

307| `codex://threads/new` | A new local chat. |

308| `codex://threads/new?<query>` | A new local chat with optional query parameters. |

309| `codex://new?<query>` | A new local chat. Include at least one of `prompt`, `path`, or `originUrl`; otherwise the link does nothing. |

~~310~~

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

~~312~~

313| Query parameter | Required | What it does |

314| ---------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |

315| `prompt=<text>` | No | Sets the initial composer text. |

316| `path=<absolute-path>` | No | Opens 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. |

317| `originUrl=<git-remote-url>` | No | Matches one of your current workspace roots by Git remote URL. If `path` is also present, Codex resolves `path` first. |

~~318~~

319Example: [Show me some fun stats about how I've been using Codex](codex://threads/new?prompt=Show%20me%20some%20fun%20stats%20about%20how%20I%27ve%20been%20using%20Codex)

~~320~~

321<a id="start-a-task-with-a-plugin"></a>

~~322~~

323#### Start a chat with a plugin

~~324~~

325To help users start a plugin-backed chat, include a plugin mention in the

326prompt before you encode it:

~~327~~

328```text

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

330```

~~331~~

332Encode the complete prompt as a URI component—for example, with

333`encodeURIComponent` in JavaScript—and pass it to the `prompt` parameter:

~~334~~

335```text

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

337```

~~338~~

339The link opens a new chat with the decoded prompt in the composer. It doesn't

340send the prompt automatically. After the user sends it, Codex can use an

341installed plugin in that chat. If the plugin isn't installed but is available

342to the user, Codex asks the user to install it and connect any required connectors.

343After setup, the user can select **Continue** to resume the same chat. Workspace

344settings can limit which plugins a user can install. For plugin installation

345and permission details, see [Plugins](https://learn.chatgpt.com/docs/plugins).

~~346~~

347### Settings

~~348~~

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

~~350~~

351| Deep link | Opens |

352| ------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |

353| `codex://settings` | Settings. |

354| `codex://settings/browser-use` | Browser settings. |

355| `codex://settings/computer-use/google-chrome` | Google Chrome settings for computer use. |

356| `codex://settings/connections` | Remote connections settings. |

357| `codex://settings/connections/computer` | Settings for controlling this Mac or PC from another device. |

358| `codex://settings/connections/devices` | Settings for controlling other devices. |

359| `codex://settings/connections/ssh` | SSH connection settings. |

360| `codex://settings/connections/ssh/add?name=<ssh-config-host>` | Adds the named host alias as a Codex-managed connection, then opens SSH connection settings. |

~~361~~

362The `name` value must match a host alias in `~/.ssh/config`. The link disables

363automatic connection for the added host. If Codex can't find the named host, it

364opens SSH connection settings and shows an error.

~~365~~

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

~~367~~

368### Skills

~~369~~

370Use these links when you need to open Skills.

~~371~~

372| Deep link | Opens |

373| ---------------- | ------- |

374| `codex://skills` | Skills. |

~~375~~

376### Scheduled

~~377~~

378Use these links when you need to open **Scheduled**.

~~379~~

380| Deep link | Opens |

381| --------------------- | ------------------------------------ |

382| `codex://automations` | Scheduled with the create flow open. |

~~383~~

384### Plugins

~~385~~

386Plugin 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](https://learn.chatgpt.com/docs/plugins). For local or repo marketplace setup, see [Build plugins](https://developers.openai.com/plugins/build/plugins#build-your-own-curated-plugin-list).

~~387~~

388#### Plugin install

~~389~~

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

~~391~~

392| Deep link | Opens |

393| ---------------------------------------------------------------------- | ----------------------------------------------- |

394| `codex://plugins/install/<plugin-name>?marketplace=<marketplace-name>` | The plugin detail or install flow for a plugin. |

~~395~~

396| Query parameter | Required | What it does |

397| -------------------------------- | -------- | ------------------------------------------------------------------------------- |

398| `marketplace=<marketplace-name>` | Yes | Identifies the marketplace. For an OpenAI-curated plugin, use `openai-curated`. |

~~399~~

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

~~401~~

402#### Plugin detail

~~403~~

404| Deep link | Opens |

405| ----------------------------- | --------------------- |

406| `codex://plugins/<plugin-id>` | A plugin detail page. |

~~407~~

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

~~409~~

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

~~411~~

412| Query parameter | Required | What it does |

413| ------------------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |

414| `hostId=<host-id>` | No | Identifies the Codex host that owns the plugin context, such as `local` or one of your configured remote connections. Codex provides these IDs. |

415| `source=manage` | No | Preserves the app's plugin-management entry point. It's not admin-only. |

~~416~~

417Example: [Open the OpenAI Developers plugin](codex://plugins/openai-developers@openai-curated)

~~418~~

419#### Local plugin

~~420~~

421For local or repo marketplace setup, see [Build plugins](https://developers.openai.com/plugins/build/plugins#build-your-own-curated-plugin-list).

~~422~~

423| Deep link | Opens |

424| --------------------------------------------------------------------------- | ---------------------------------------------------- |

425| `codex://plugins/<plugin-name>?marketplacePath=<absolute-marketplace-path>` | A local plugin detail page from a local marketplace. |

~~426~~

427| Query parameter | Required | What it does |

428| --------------------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------- |

429| `marketplacePath=<absolute-marketplace-path>` | Yes | Absolute path to the local `marketplace.json`, for example `/Users/alex/.agents/plugins/marketplace.json`. |

430| `mode=share` | No | Opens the share flow for that local plugin. |

~~431~~

432### Pets

~~433~~

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

~~435~~

436| Deep link | Opens |

437| ----------------------------------------------------------------- | --------------------- |

438| `codex://pets/install?name=<pet-name>&imageUrl=<https-image-url>` | The pet install flow. |

~~439~~

440| Query parameter | Required | What it does |

441| ------------------------------ | -------- | ------------------------------------------------------------------------------------------- |

442| `name=<pet-name>` | Yes | Sets the pet name. The value must contain at least one non-whitespace character. |

443| `imageUrl=<https-image-url>` | Yes | Provides an absolute HTTPS URL for the pet image or sprite sheet. |

444| `description=<text>` | No | Adds a description to the install flow. |

445| `spriteVersionNumber=<1-or-2>` | No | Selects the sprite-sheet format. The default is `1`; the only other supported value is `2`. |

~~446~~

447The install link accepts only these query parameters. Invalid names, non-HTTPS

448image URLs, unsupported sprite versions, or extra path segments cause the link

449to do nothing.

~~450~~

451## See also

~~452~~

453- [Features](https://learn.chatgpt.com/docs/features)

454- [Settings](https://learn.chatgpt.com/docs/reference/settings)

455- [Slash commands](https://learn.chatgpt.com/docs/reference/slash-commands)

app/settings.md +0 −135 deleted

File Deleted View Diff

~~1# Settings~~

~~3> For the complete documentation index, see [llms.txt](https://learn.chatgpt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to the page URL.~~

~~5Use the settings panel to personalize the app and manage everyday preferences.~~

~~6Open [**Settings**](codex://settings) from the app menu or press~~

~~8<kbd>Cmd</kbd>+<kbd>,</kbd> on macOS or <kbd>Ctrl</kbd>+<kbd>,</kbd> on Windows.~~

~~10## General~~

~~12Require <kbd>Cmd</kbd>+<kbd>Enter</kbd> for multiline prompts, or turn on~~

~~13**Prevent sleep while running** so local chats can continue while you step away.~~

~~14Under **Follow-up behavior**, choose whether a message sent while ChatGPT works~~

~~15should steer the current run or wait for the next run.~~

~~17## Profile~~

~~19Use **Profile** to review activity insights, lifetime tokens, peak tokens,~~

~~20streaks, your longest task, and token activity. You can also update your profile~~

~~21details, such as your picture, display name, and username, and save a profile~~

~~22card with usage highlights. Sharing profile cards is available on consumer~~

~~23ChatGPT plans.~~

~~25Eligible users can also send Codex invitations from the profile menu. Choose~~

~~26**Invite a friend** on an eligible personal plan or **Invite a coworker** in an~~

~~27eligible Business workspace. See~~

~~28[Invite friends and coworkers](https://learn.chatgpt.com/docs/pricing#invite-friends-and-coworkers) for~~

~~29current rewards, limits, and eligibility.~~

~~31## Keyboard shortcuts~~

~~33Open **Keyboard Shortcuts** to review commands, change bindings, or reset custom~~

~~34shortcuts to their defaults. Use the search field to find shortcuts by command~~

~~35name, or switch to keystroke search and press a key combination to find the~~

~~36command that uses it.~~

~~38## Notifications~~

~~40Choose when turn completion notifications appear, and whether the app should prompt for~~

~~41notification permissions.~~

~~43## Appearance~~

~~45In **Settings**, you can change the app appearance by choosing a base theme,~~

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

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

~~52> Illustration: ChatGPT desktop app Appearance settings showing theme selection, color controls, and font options~~

~~57## Pets~~

~~63 Pets are optional animated companions for the app. In **Settings > Pets**,~~

64 choose a built-in or custom pet, then use `/pet`, **Show pet**, or **Hide pet**

~~65 to control the floating overlay. Choose **Mini** to keep the chat controls~~

~~66 visible without a pet.~~

~~68 See [Pets](https://learn.chatgpt.com/docs/pets?surface=app) to start chats, use voice, follow~~

~~69 activity, or create your own pet.~~

~~74 <CodexPetsDemo client:load />~~

~~78<a id="browser-use"></a>~~

~~80## Browser~~

~~82Use these settings to install or enable the bundled Browser plugin, set up the~~

~~83[browser extension](https://learn.chatgpt.com/docs/chrome-extension), and manage allowed and blocked~~

~~84websites. ChatGPT asks before using a website unless you've allowed it. Removing~~

~~85a blocked site lets ChatGPT ask again before using it in the browser.~~

~~87See [Built-in browser](https://learn.chatgpt.com/docs/browser?surface=app) for browser preview, comment, and~~

~~88Computer Use workflows.~~

~~90## Computer Use~~

~~92Check your Computer Use settings to review desktop-app access and related~~

~~93preferences after setup. On macOS, revoke system-level access by updating Screen~~

~~94Recording or Accessibility permissions in macOS Privacy & Security settings.~~

~~96## Personalization~~

~~98Choose **Friendly**, **Pragmatic**, or **None** as your default personality. Use~~

~~99**None** to disable personality instructions. You can update this at any time.~~

~~100~~

101You can also add your own custom instructions. Editing custom instructions updates your

102[personal instructions in `AGENTS.md`](https://learn.chatgpt.com/docs/agent-configuration/agents-md).

~~103~~

104## Suggested prompts

~~105~~

106Use context-aware suggestions to surface follow-ups and tasks you may want to resume when you

107start or return to ChatGPT.

~~108~~

109## Memories

~~110~~

111Enable Memories, where available, to let ChatGPT carry useful context from past

112chats into future work. See [Memories](https://learn.chatgpt.com/docs/customization/memories)

113for setup, storage, and controls for individual chats.

~~114~~

115<a id="archived-tasks"></a>

~~116~~

117## Archived chats

~~118~~

119The **Archived chats** section lists archived chats with dates and project

120context. Use **Unarchive** to restore a chat.

~~121~~

122<a id="keep-an-app-task-near-your-work"></a>

123<a id="keep-an-app-chat-near-your-work"></a>

124<a id="keep-a-task-near-your-work"></a>

~~125~~

126## Keep a chat near your work

~~127~~

128In the ChatGPT desktop app, pop out an active chat into a separate window and place it

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

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

~~131~~

~~132~~

~~133~~

~~134~~

135> Illustration: ChatGPT desktop app chat displayed in a floating pop-out window

auth.md +0 −5

Details

185For setup steps, permissions, rotation, and revocation guidance, see185For setup steps, permissions, rotation, and revocation guidance, see

186[Access tokens](https://learn.chatgpt.com/docs/enterprise/access-tokens).186[Access tokens](https://learn.chatgpt.com/docs/enterprise/access-tokens).

187 187

188If your cloud platform, CI system, or cluster already issues short-lived

189workload tokens, use

190[workload identity federation](https://learn.chatgpt.com/docs/enterprise/workload-identity)

191instead of storing an OpenAI credential.

~~192~~

193</ContentModeSwitch>188</ContentModeSwitch>

194 189

195<ContentModeSwitch group="codex-surface" id="cli">190<ContentModeSwitch group="codex-surface" id="cli">

cli/reference.md +0 −455 deleted