# Codex Command reference

> Codex: CLI startup, subcommands, slash commands, session recovery, permissions and configuration overrides.

URL: https://docs.passion8.cc/en/docs/codex/commands
Language: en
Publisher: Passion8

This is a quick reference for startup commands, subcommands, interactive slash commands and temporary configuration overrides. The `/` menu in your installed version is authoritative.




The base URL is `https://passion8.cc/v1`, including `/v1`. See [CLI configuration](https://docs.passion8.cc/en/docs/codex/config).




## Startup and subcommands

| Command | Purpose |
| --- | --- |
| `codex` | Open the interactive TUI |
| `codex "Explain this project"` | Start with an initial prompt |
| `codex exec "..."` | Run non-interactively and exit; useful for scripts and CI |
| `codex app [PATH]` | Launch the desktop client; open a workspace on supported platforms |
| `codex app-server` | Start the protocol server for desktop, remote or integration work |
| `codex apply <TASK_ID>` | Apply a Codex Cloud task's diff locally |
| `codex cloud` | Browse or submit Codex Cloud tasks |
| `codex resume` | Select a saved session |
| `codex resume --last` | Resume the latest session |
| `codex fork` | Fork a saved conversation |
| `codex archive` / `codex unarchive` | Archive or restore sessions |
| `codex delete` | Permanently delete a session |
| `codex doctor` | Diagnose installation, configuration, authentication, Git and terminal setup |
| `codex features` | Inspect and persistently enable/disable feature flags |
| `codex login` / `codex logout` | Manage client authentication; not required before the Passion8 file setup |
| `codex --profile <name>` | Start with a named profile |
| `codex --model <name>` | Select a model for this run |
| `codex -C <directory>` | Select the working directory |
| `codex mcp` | Manage MCP servers |
| `codex mcp-server` | Expose Codex as an MCP server |
| `codex plugin` | Manage plugins |
| `codex plugin marketplace` | Manage plugin marketplaces |
| `codex remote-control` | Prepare the local app-server daemon for remote control |
| `codex sandbox` | Execute a command in a Codex sandbox |
| `codex update` | Check for and apply CLI updates |
| `codex --version` | Show the version |

## Overrides and permission flags

Override settings for one run without editing config.toml:

| Flag | Purpose |
| --- | --- |
| `-c key=value` | Override a setting, such as `-c model_reasoning_effort=high` |
| `-a` / `--ask-for-approval <policy>` | Set approval policy: on-request / never |
| `-s` / `--sandbox <mode>` | read-only / workspace-write / danger-full-access |
| `--add-dir <path>` | Grant access to an additional directory; repeat as needed |
| `--image <path[,path...]>` | Attach images to the initial prompt |
| `--oss` | Use a local open-source provider, typically requiring a running local service |
| `--remote <url>` | Connect to a remote app-server using supported transports |
| `--remote-auth-token-env <ENV>` | Read the remote bearer token from an environment variable |
| `--search` | Enable live web search instead of the normal cached mode |
| `--strict-config` | Reject unrecognized configuration fields |
| `--full-auto` | Deprecated compatibility flag; use explicit sandbox and approval settings |
| `--dangerously-bypass-approvals-and-sandbox` | Bypass boundaries; only for controlled, recoverable environments |




Do not use unrestricted execution as a default in unfamiliar repositories, production directories or directories containing secrets. See [Security](https://docs.passion8.cc/en/docs/security).




## Interactive slash commands

Enter `/` in the TUI to open its command menu:

| Command | Purpose |
| --- | --- |
| `/model` | Change model and reasoning effort |
| `/fast` | Select Fast service tier when the model catalog supports it |
| `/personality` | Change communication style: friendly, pragmatic or none |
| `/permissions` | Change approval and permission mode |
| `/approve` | Approve a retry of the last action rejected by automatic review |
| `/plan` | Enter planning mode, optionally with an inline prompt |
| `/goal` | Set, inspect, pause, resume or clear a goal |
| `/init` | Generate an initial AGENTS.md |
| `/diff` | Inspect the current Git diff |
| `/review` | Review the working tree |
| `/mention` | Attach a file using @ |
| `/compact` | Compact the context of a long conversation |
| `/clear` | Clear the display and start a new conversation |
| `/new` | Start a new conversation in the same CLI session |
| `/status` | Inspect session status and configuration |
| `/usage` | Inspect account usage or rate-limit reset information |
| `/mcp` | Inspect connected MCP servers and tools |
| `/ide` | Include open-file/selection context from the IDE |
| `/agent` | Switch to or inspect a spawned agent thread |
| `/ps` | Inspect background terminals and recent output |
| `/stop` | Stop background terminals in the current session |
| `/fork` | Fork the current conversation |
| `/side` / `/btw` | Open a side conversation without interrupting the main transcript |
| `/raw` | Toggle raw scrollback for copying long output |
| `/resume` | Resume from the session list |
| `/archive` | Archive the current session and exit |
| `/delete` | Permanently delete the current session and exit |
| `/apps` | Browse connectors/apps and insert an app reference |
| `/plugins` | Browse, install and manage plugins |
| `/hooks` | Inspect lifecycle hooks |
| `/skills` | Browse and use skills |
| `/memories` | Configure memory use and generation |
| `/import` | Import supported Claude Code setup, project files or recent chats |
| `/debug-config` | Inspect configuration layers and requirements |
| `/statusline` | Configure footer fields |
| `/title` | Configure terminal-window/tab title fields |
| `/theme` | Select syntax highlighting |
| `/keymap` | Inspect and save key mappings |
| `/vim` | Toggle Vim-style composition |
| `/logout` | Clear local credentials |
| `/feedback` | Send feedback and logs to maintainers |




Commands change by version. Use the current menu; typing `@` also searches and references files.




## Resume a saved session

Continue without repeating all background information:

```bash
codex resume          # Select a session
codex resume --last   # Resume the latest
```

## Continue reading



- [Advanced usage](https://docs.passion8.cc/en/docs/codex/tips): AGENTS.md, profiles, MCP, exec and permissions.
- [Troubleshooting](https://docs.passion8.cc/en/docs/codex/troubleshooting): Authentication, /v1 and Responses errors.



## Official references

- [CLI reference](https://developers.openai.com/codex/cli/reference)
- [Codex manual: slash commands](https://developers.openai.com/codex/codex-manual.md)