cli/slash-commands.md +194 −11
8This guide shows you how to:8This guide shows you how to:
9 9
10- Find the right built-in slash command for a task10- Find the right built-in slash command for a task
1111- Steer an active session with commands like `/model`, `/personality`,- Steer an active session with commands like `/model`, `/fast`,
1212 `/permissions`, `/experimental`, `/agent`, and `/status` `/personality`, `/permissions`, `/approve`, `/raw`, `/agent`, and `/status`
13 13
14## Built-in slash commands14## Built-in slash commands
15 15
16Codex ships with the following commands. Open the slash popup and start typing16Codex ships with the following commands. Open the slash popup and start typing
17the command name to filter the list.17the command name to filter the list.
18 18
19When a task is already running, you can type a slash command and press `Tab` to
20queue it for the next turn. Codex parses queued slash commands when they run, so
21command menus and errors appear after the current turn finishes. Slash
22completion still works before you queue the command.
23
19| Command | Purpose | When to use it |24| Command | Purpose | When to use it |
20| ------------------------------------------------------------------------------- | --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |25| ------------------------------------------------------------------------------- | --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
21| [`/permissions`](#update-permissions-with-permissions) | Set what Codex can do without asking first. | Relax or tighten approval requirements mid-session, such as switching between Auto and Read Only. |26| [`/permissions`](#update-permissions-with-permissions) | Set what Codex can do without asking first. | Relax or tighten approval requirements mid-session, such as switching between Auto and Read Only. |
27| [`/ide`](#include-ide-context-with-ide) | Include open files, current selection, and other IDE context. | Pull editor context into the next prompt without re-explaining what's open in your IDE. |
28| [`/keymap`](#remap-tui-shortcuts-with-keymap) | Remap TUI keyboard shortcuts. | Inspect and persist custom shortcut bindings in `config.toml`. |
29| [`/vim`](#toggle-vim-mode-with-vim) | Toggle Vim mode for the composer. | Switch between Vim normal/insert behavior and the default composer editing mode. |
22| [`/sandbox-add-read-dir`](#grant-sandbox-read-access-with-sandbox-add-read-dir) | Grant sandbox read access to an extra directory (Windows only). | Unblock commands that need to read an absolute directory path outside the current readable roots. |30| [`/sandbox-add-read-dir`](#grant-sandbox-read-access-with-sandbox-add-read-dir) | Grant sandbox read access to an extra directory (Windows only). | Unblock commands that need to read an absolute directory path outside the current readable roots. |
2331| [`/agent`](#switch-agent-threads-with-agent) | Switch the active agent thread. | Inspect or continue work in a spawned sub-agent thread. || [`/agent`](#switch-agent-threads-with-agent) | Switch the active agent thread. | Inspect or continue work in a spawned subagent thread. |
24| [`/apps`](#browse-apps-with-apps) | Browse apps (connectors) and insert them into your prompt. | Attach an app as `$app-slug` before asking Codex to use it. |32| [`/apps`](#browse-apps-with-apps) | Browse apps (connectors) and insert them into your prompt. | Attach an app as `$app-slug` before asking Codex to use it. |
2533| [`/clear`](#clear-the-terminal-and-start-a-new-chat-with-clear) | Clear the terminal and start a fresh chat. | Reset the visible UI and conversation together when you want a clean slate. || [`/plugins`](#browse-plugins-with-plugins) | Browse installed and discoverable plugins. | Inspect plugin tools, install suggested plugins, or manage plugin availability. |
34| [`/hooks`](#review-hooks-with-hooks) | Review lifecycle hooks. | Inspect configured hooks, trust new or changed hooks, or disable non-managed hooks before they run. |
35| [`/clear`](#clear-the-terminal-and-start-a-new-chat-with-clear) | Clear the terminal and start a fresh chat. | Reset the visible UI and conversation together when you want a fresh start. |
26| [`/compact`](#keep-transcripts-lean-with-compact) | Summarize the visible conversation to free tokens. | Use after long runs so Codex retains key points without blowing the context window. |36| [`/compact`](#keep-transcripts-lean-with-compact) | Summarize the visible conversation to free tokens. | Use after long runs so Codex retains key points without blowing the context window. |
2737| [`/copy`](#copy-the-latest-response-with-copy) | Copy the latest completed Codex output. | Grab the latest finished response or plan text without manually selecting it. || [`/copy`](#copy-the-latest-response-with-copy) | Copy the latest completed Codex output. | Grab the latest finished response or plan text without manually selecting it. You can also press `Ctrl+O`. |
28| [`/diff`](#review-changes-with-diff) | Show the Git diff, including files Git isn't tracking yet. | Review Codex's edits before you commit or run tests. |38| [`/diff`](#review-changes-with-diff) | Show the Git diff, including files Git isn't tracking yet. | Review Codex's edits before you commit or run tests. |
29| [`/exit`](#exit-the-cli-with-quit-or-exit) | Exit the CLI (same as `/quit`). | Alternative spelling; both commands exit the session. |39| [`/exit`](#exit-the-cli-with-quit-or-exit) | Exit the CLI (same as `/quit`). | Alternative spelling; both commands exit the session. |
3040| [`/experimental`](#toggle-experimental-features-with-experimental) | Toggle experimental features. | Enable optional features such as sub-agents from the CLI. || [`/experimental`](#toggle-experimental-features-with-experimental) | Toggle experimental features. | Enable optional features such as subagents from the CLI. |
41| [`/approve`](#approve-an-auto-review-denial-with-approve) | Approve one retry of a recent auto review denial. | Retry a command or action that the auto reviewer denied. |
42| [`/memories`](#configure-memories-with-memories) | Configure memory use and generation. | Turn memory injection or memory generation on or off without leaving the TUI. |
43| [`/skills`](#use-skills-with-skills) | Browse and use skills. | Improve task-specific behavior by selecting a relevant local skill. |
44| [`/hooks`](#view-lifecycle-hooks-with-hooks) | View and manage lifecycle hooks. | Inspect hook configuration loaded into the current session. |
31| [`/feedback`](#send-feedback-with-feedback) | Send logs to the Codex maintainers. | Report issues or share diagnostics with support. |45| [`/feedback`](#send-feedback-with-feedback) | Send logs to the Codex maintainers. | Report issues or share diagnostics with support. |
32| [`/init`](#generate-agentsmd-with-init) | Generate an `AGENTS.md` scaffold in the current directory. | Capture persistent instructions for the repository or subdirectory you're working in. |46| [`/init`](#generate-agentsmd-with-init) | Generate an `AGENTS.md` scaffold in the current directory. | Capture persistent instructions for the repository or subdirectory you're working in. |
33| [`/logout`](#sign-out-with-logout) | Sign out of Codex. | Clear local credentials when using a shared machine. |47| [`/logout`](#sign-out-with-logout) | Sign out of Codex. | Clear local credentials when using a shared machine. |
3448| [`/mcp`](#list-mcp-tools-with-mcp) | List configured Model Context Protocol (MCP) tools. | Check which external tools Codex can call during the session. || [`/mcp`](#list-mcp-tools-with-mcp) | List configured Model Context Protocol (MCP) tools. | Check which external tools Codex can call during the session; add `verbose` for server details. |
35| [`/mention`](#highlight-files-with-mention) | Attach a file to the conversation. | Point Codex at specific files or folders you want it to inspect next. |49| [`/mention`](#highlight-files-with-mention) | Attach a file to the conversation. | Point Codex at specific files or folders you want it to inspect next. |
36| [`/model`](#set-the-active-model-with-model) | Choose the active model (and reasoning effort, when available). | Switch between general-purpose models (`gpt-4.1-mini`) and deeper reasoning models before running a task. |50| [`/model`](#set-the-active-model-with-model) | Choose the active model (and reasoning effort, when available). | Switch between general-purpose models (`gpt-4.1-mini`) and deeper reasoning models before running a task. |
51| [`/fast`](#toggle-fast-mode-with-fast) | Toggle a Fast service tier when the model catalog exposes one. | Turn the current model's Fast tier on or off, or check whether the thread is using it. |
37| [`/plan`](#switch-to-plan-mode-with-plan) | Switch to plan mode and optionally send a prompt. | Ask Codex to propose an execution plan before implementation work starts. |52| [`/plan`](#switch-to-plan-mode-with-plan) | Switch to plan mode and optionally send a prompt. | Ask Codex to propose an execution plan before implementation work starts. |
53| [`/goal`](#set-or-view-an-experimental-task-goal-with-goal) | Set, pause, resume, view, or clear a task goal. | Give Codex a persistent target to track while a larger task runs. Requires `features.goals`. |
38| [`/personality`](#set-a-communication-style-with-personality) | Choose a communication style for responses. | Make Codex more concise, more explanatory, or more collaborative without changing your instructions. |54| [`/personality`](#set-a-communication-style-with-personality) | Choose a communication style for responses. | Make Codex more concise, more explanatory, or more collaborative without changing your instructions. |
39| [`/ps`](#check-background-terminals-with-ps) | Show experimental background terminals and their recent output. | Check long-running commands without leaving the main transcript. |55| [`/ps`](#check-background-terminals-with-ps) | Show experimental background terminals and their recent output. | Check long-running commands without leaving the main transcript. |
56| [`/stop`](#stop-background-terminals-with-stop) | Stop all background terminals. | Cancel background terminal work started by the current session. |
40| [`/fork`](#fork-the-current-conversation-with-fork) | Fork the current conversation into a new thread. | Branch the active session to explore a new approach without losing the current transcript. |57| [`/fork`](#fork-the-current-conversation-with-fork) | Fork the current conversation into a new thread. | Branch the active session to explore a new approach without losing the current transcript. |
58| [`/side`](#start-a-side-conversation-with-side) | Start an ephemeral side conversation. | Ask a focused follow-up without disrupting the main thread's transcript. |
59| [`/raw`](#toggle-raw-scrollback-with-raw) | Toggle raw scrollback mode. | Make terminal selection and copying less formatted while reviewing long output. |
41| [`/resume`](#resume-a-saved-conversation-with-resume) | Resume a saved conversation from your session list. | Continue work from a previous CLI session without starting over. |60| [`/resume`](#resume-a-saved-conversation-with-resume) | Resume a saved conversation from your session list. | Continue work from a previous CLI session without starting over. |
42| [`/new`](#start-a-new-conversation-with-new) | Start a new conversation inside the same CLI session. | Reset the chat context without leaving the CLI when you want a fresh prompt in the same repo. |61| [`/new`](#start-a-new-conversation-with-new) | Start a new conversation inside the same CLI session. | Reset the chat context without leaving the CLI when you want a fresh prompt in the same repo. |
43| [`/quit`](#exit-the-cli-with-quit-or-exit) | Exit the CLI. | Leave the session immediately. |62| [`/quit`](#exit-the-cli-with-quit-or-exit) | Exit the CLI. | Leave the session immediately. |
45| [`/status`](#inspect-the-session-with-status) | Display session configuration and token usage. | Confirm the active model, approval policy, writable roots, and remaining context capacity. |64| [`/status`](#inspect-the-session-with-status) | Display session configuration and token usage. | Confirm the active model, approval policy, writable roots, and remaining context capacity. |
46| [`/debug-config`](#inspect-config-layers-with-debug-config) | Print config layer and requirements diagnostics. | Debug precedence and policy requirements, including experimental network constraints. |65| [`/debug-config`](#inspect-config-layers-with-debug-config) | Print config layer and requirements diagnostics. | Debug precedence and policy requirements, including experimental network constraints. |
47| [`/statusline`](#configure-footer-items-with-statusline) | Configure TUI status-line fields interactively. | Pick and reorder footer items (model/context/limits/git/tokens/session) and persist in config.toml. |66| [`/statusline`](#configure-footer-items-with-statusline) | Configure TUI status-line fields interactively. | Pick and reorder footer items (model/context/limits/git/tokens/session) and persist in config.toml. |
67| [`/title`](#configure-terminal-title-items-with-title) | Configure terminal window or tab title fields interactively. | Pick and reorder title items such as project, status, thread, branch, model, and task progress. |
68| [`/theme`](#choose-a-syntax-theme-with-theme) | Choose a syntax-highlighting theme. | Preview and persist a terminal syntax-highlighting theme. |
48 69
49`/quit` and `/exit` both exit the CLI. Use them only after you have saved or70`/quit` and `/exit` both exit the CLI. Use them only after you have saved or
50committed any important work.71committed any important work.
51 72
5273The `/approvals` command still works as an alias, but it no longer appears in the slash popup list.Use `/permissions` to adjust what Codex can do without asking first. Use
74`/approve` only when you need to retry a recent action that automatic review
75denied.
53 76
54## Control your session with slash commands77## Control your session with slash commands
55 78
63 86
64Expected: Codex confirms the new model in the transcript. Run `/status` to verify the change.87Expected: Codex confirms the new model in the transcript. Run `/status` to verify the change.
65 88
89### Toggle Fast mode with `/fast`
90
911. Type `/fast on`, `/fast off`, or `/fast status`.
922. If you want the setting to persist, confirm the update when Codex offers to save it.
93
94Expected: Codex reports whether the current model's Fast service tier is on or
95off for the current thread. In the TUI footer, you can also show a Fast mode
96status-line item with `/statusline`.
97
98Fast tier commands are catalog-driven. If the current model doesn't advertise a
99Fast tier, Codex won't show `/fast`.
100
66### Set a communication style with `/personality`101### Set a communication style with `/personality`
67 102
68Use `/personality` to change how Codex communicates without rewriting your prompt.103Use `/personality` to change how Codex communicates without rewriting your prompt.
82 117
831. Type `/plan` and press Enter to switch the active conversation into plan1181. Type `/plan` and press Enter to switch the active conversation into plan
84 mode.119 mode.
851202. Optional: provide inline prompt text (for example, `/plan Propose a migration plan for this service`).2. Optional: provide inline prompt text (for example, `/plan Propose a
121migration plan for this service`).
863. You can paste content or attach images while using inline `/plan` arguments.1223. You can paste content or attach images while using inline `/plan` arguments.
87 123
88Expected: Codex enters plan mode and uses your optional inline prompt as the first planning request.124Expected: Codex enters plan mode and uses your optional inline prompt as the first planning request.
89 125
90While a task is already running, `/plan` is temporarily unavailable.126While a task is already running, `/plan` is temporarily unavailable.
91 127
128### Set an experimental goal with `/goal`
129
130`/goal` is experimental and only available when `features.goals` is enabled. To enable it, open `/experimental` or add `goals = true` under `[features]` in `config.toml`.
131
1321. Type `/goal <objective>` to set the goal, for example `/goal Finish the migration and keep tests green`.
1332. Type `/goal` to view the current goal.
1343. Use `/goal pause`, `/goal resume`, or `/goal clear` to pause, resume, or remove it.
135
136Expected: Codex keeps the goal attached to the active thread while work continues.
137
138Goal objectives must be non-empty and at most 4,000 characters. For longer
139instructions, put the details in a file and point the goal at that file.
140
92### Toggle experimental features with `/experimental`141### Toggle experimental features with `/experimental`
93 142
941. Type `/experimental` and press Enter.1431. Type `/experimental` and press Enter.
951442. Toggle the features you want (for example, **Multi-agents**), then restart Codex.2. Toggle the features you want (for example, Apps or Smart Approvals), then restart Codex if the prompt asks you to.
96 145
97Expected: Codex saves your feature choices to config and applies them on restart.146Expected: Codex saves your feature choices to config and applies them on restart.
98 147
148### Approve an auto review denial with `/approve`
149
150Use `/approve` when the automatic reviewer denied a recent action and you want
151Codex to retry it once.
152
1531. Type `/approve`.
1542. Confirm the retry when Codex shows the relevant denied action.
155
156Expected: Codex retries that denied action once under the current session
157policy.
158
159### Configure memories with `/memories`
160
1611. Type `/memories`.
1622. Choose whether Codex should use existing memories, generate new memories, or
163 keep memory behavior disabled.
164
165Expected: Codex updates the relevant memory settings for future sessions.
166
167### Use skills with `/skills`
168
1691. Type `/skills`.
1702. Pick the skill you want Codex to apply.
171
172Expected: Codex inserts the selected skill context so the next request follows
173that skill's instructions.
174
175### View lifecycle hooks with `/hooks`
176
1771. Type `/hooks`.
1782. Review the loaded lifecycle hook configuration.
179
180Expected: Codex shows the hooks that can run in the current session.
181
99### Clear the terminal and start a new chat with `/clear`182### Clear the terminal and start a new chat with `/clear`
100 183
1011. Type `/clear` and press Enter.1841. Type `/clear` and press Enter.
117Expected: Codex announces the updated policy. Future actions respect the200Expected: Codex announces the updated policy. Future actions respect the
118updated approval mode until you change it again.201updated approval mode until you change it again.
119 202
203### Include IDE context with `/ide`
204
2051. Type `/ide`.
2062. Add optional inline text if you want to explain what Codex should do with the
207 current IDE selection or open files.
208
209Expected: Codex includes available IDE context in the next prompt.
210
211### Toggle Vim mode with `/vim`
212
2131. Type `/vim`.
2142. Continue editing in the composer.
215
216Expected: Codex toggles composer Vim mode for the current session. To make Vim
217mode the default for new sessions, set `tui.vim_mode_default = true` in
218`config.toml`.
219
120### Copy the latest response with `/copy`220### Copy the latest response with `/copy`
121 221
1221. Type `/copy` and press Enter.2221. Type `/copy` and press Enter.
127the in-progress response. The command is unavailable before the first completed227the in-progress response. The command is unavailable before the first completed
128Codex output and immediately after a rollback.228Codex output and immediately after a rollback.
129 229
230You can also press <kbd>Ctrl</kbd>+<kbd>O</kbd> from the main TUI to copy the
231latest completed response without opening the slash command menu.
232
233### Toggle raw scrollback with `/raw`
234
2351. Type `/raw`, `/raw on`, or `/raw off`.
236
237Expected: Codex toggles raw scrollback mode, which makes terminal selection and
238copying more direct. You can also use the default <kbd>Alt</kbd>+<kbd>R</kbd>
239binding or persist the default with `tui.raw_output_mode = true`.
240
130### Grant sandbox read access with `/sandbox-add-read-dir`241### Grant sandbox read access with `/sandbox-add-read-dir`
131 242
132This command is available only when running the CLI natively on Windows.243This command is available only when running the CLI natively on Windows.
169limits, git branch, token counters, session id, current directory/project root,280limits, git branch, token counters, session id, current directory/project root,
170and Codex version.281and Codex version.
171 282
283### Configure terminal title items with `/title`
284
2851. Type `/title`.
2862. Use the picker to toggle and reorder items, then confirm.
287
288Expected: The terminal window or tab title updates immediately and persists to
289`tui.terminal_title` in `config.toml`.
290
291Available title items include app name, project, spinner, status, thread, git
292branch, model, and task progress.
293
294### Choose a syntax theme with `/theme`
295
2961. Type `/theme`.
2972. Preview a theme from the picker, then confirm.
298
299Expected: Codex updates syntax highlighting and persists the choice to
300`tui.theme` in `config.toml`.
301
302### Remap TUI shortcuts with `/keymap`
303
304Use `/keymap` to inspect, update, and persist keyboard shortcut bindings for the TUI.
305
3061. Type `/keymap`.
3072. Pick the shortcut context and action you want to change.
3083. Enter the new binding or remove the existing one.
309
310Expected: Codex updates the active keymap and writes the custom binding to `tui.keymap` in `config.toml`.
311
312Key bindings use names such as `ctrl-a`, `shift-enter`, and `page-down`. Context-specific bindings override `tui.keymap.global`; an empty binding list unbinds the action.
313
172### Check background terminals with `/ps`314### Check background terminals with `/ps`
173 315
1741. Type `/ps`.3161. Type `/ps`.
179 321
180Background terminals appear when `unified_exec` is in use; otherwise, the list may be empty.322Background terminals appear when `unified_exec` is in use; otherwise, the list may be empty.
181 323
324### Stop background terminals with `/stop`
325
3261. Type `/stop`.
3272. Confirm if Codex asks before stopping the listed terminals.
328
329Expected: Codex stops all background terminals for the current session. `/clean`
330is still available as an alias for `/stop`.
331
182### Keep transcripts lean with `/compact`332### Keep transcripts lean with `/compact`
183 333
1841. After a long exchange, type `/compact`.3341. After a long exchange, type `/compact`.
209Expected: Codex starts a fresh conversation in the same CLI session, so you359Expected: Codex starts a fresh conversation in the same CLI session, so you
210can switch tasks without leaving your terminal.360can switch tasks without leaving your terminal.
211 361
212362Unlike `/clear`, `/new` does not clear the current terminal view first.Unlike `/clear`, `/new` doesn't clear the current terminal view first.
213 363
214### Resume a saved conversation with `/resume`364### Resume a saved conversation with `/resume`
215 365
230If you need to fork a saved session instead of the current one, run380If you need to fork a saved session instead of the current one, run
231`codex fork` in your terminal to open the session picker.381`codex fork` in your terminal to open the session picker.
232 382
383### Start a side conversation with `/side`
384
385Use `/side` to start an ephemeral fork from the current conversation without switching away from the main task.
386
3871. Type `/side` to open a side conversation.
3882. Optionally add inline text, for example `/side Check whether this plan has an obvious risk`.
3893. Return to the parent thread after the focused detour finishes.
390
391Expected: Codex opens a side conversation whose transcript is separate from the parent thread. While you are in side mode, the TUI continues to show parent-thread status so you can see whether the main task is still running.
392
393`/side` is unavailable inside another side conversation and during review mode.
394
233### Generate `AGENTS.md` with `/init`395### Generate `AGENTS.md` with `/init`
234 396
2351. Run `/init` in the directory where you want Codex to look for persistent instructions.3971. Run `/init` in the directory where you want Codex to look for persistent instructions.
254 416
255Expected: You see the configured Model Context Protocol (MCP) tools Codex can call in this session.417Expected: You see the configured Model Context Protocol (MCP) tools Codex can call in this session.
256 418
419Use `/mcp verbose` to include detailed server diagnostics. If you pass anything other than `verbose`, Codex shows the command usage.
420
257### Browse apps with `/apps`421### Browse apps with `/apps`
258 422
2591. Type `/apps`.4231. Type `/apps`.
262Expected: Codex inserts the app mention into the composer as `$app-slug`, so426Expected: Codex inserts the app mention into the composer as `$app-slug`, so
263you can immediately ask Codex to use it.427you can immediately ask Codex to use it.
264 428
429### Browse plugins with `/plugins`
430
4311. Type `/plugins`.
4322. Choose a marketplace tab, then pick a plugin to inspect its capabilities or available actions.
433
434Expected: Codex opens the plugin browser so you can review installed plugins,
435discoverable plugins that your configuration allows, and installed plugin state.
436Press <kbd>Space</kbd> on an installed plugin to toggle its enabled state.
437
438### Review hooks with `/hooks`
439
4401. Type `/hooks`.
4412. Choose a hook event to inspect the matching handlers.
4423. Trust, disable, or re-enable non-managed hooks as needed.
443
444Expected: Codex opens the hook browser so you can review configured lifecycle
445hooks. Managed hooks appear as managed and can't be disabled from the user hook
446browser.
447
265### Switch agent threads with `/agent`448### Switch agent threads with `/agent`
266 449
2671. Type `/agent` and press Enter.4501. Type `/agent` and press Enter.