Codex
Command reference
CLI startup, subcommands, slash commands, session recovery, permissions and configuration overrides.
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.
#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.
#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:
codex resume # Select a session
codex resume --last # Resume the latest#Continue reading
Advanced usageAGENTS.md, profiles, MCP, exec and permissions.TroubleshootingAuthentication, /v1 and Responses errors.
#Official references
Support
Need help?
For setup, billing, or model issues, email us. Check the status page for uptime.
WeChat / QQ support is available at the bottom right.
