Codex CLI commands and subcommands

Launch the terminal UI. Accepts the global flags above plus an optional prompt or image attachments.

Maturity: Stable

Open the agent command center on a shared local or remote server.

Maturity: Stable

Launch the ChatGPT desktop app on macOS or Windows. On macOS, Codex can open a workspace path; on Windows, Codex prints the path to open.

Maturity: Stable

Launch the Codex app server for local development or debugging over stdio, WebSocket, or a Unix socket.

Maturity: Experimental

Apply the latest diff generated by a Codex cloud chat to your local working tree. Alias: codex a.

Maturity: Stable; alias: codex a

Archive a saved interactive session by session ID or session name.

Maturity: Stable

Browse or execute Codex cloud chats from the terminal without opening the TUI. Alias: codex cloud-tasks.

Maturity: Experimental; alias: codex cloud-tasks

Generate shell completion scripts for Bash, Zsh, Fish, or PowerShell.

Maturity: Stable

Debug app-server by sending a single V2 message through the built-in test client.

Maturity: Experimental

Print the raw model catalog Codex sees, including an option to inspect only the bundled catalog.

Maturity: Experimental

Render the model-visible prompt input list as JSON, optionally with a prompt and images.

Maturity: Experimental

Permanently delete a saved interactive session by session ID or session name.

Maturity: Stable

Generate a diagnostic report for local installation, config, auth, runtime, Git, terminal, app-server, and thread inventory issues.

Maturity: Stable

Run Codex non-interactively. Alias: codex e.

Maturity: Stable; alias: codex e

Evaluate execpolicy rule files and see whether a command would be allowed, prompted, or blocked.

Maturity: Experimental

List feature flags and persistently enable or disable them in config.toml.

Maturity: Stable

Fork a previous interactive session into a new chat, preserving the original transcript.

Maturity: Stable

Authenticate Codex using ChatGPT OAuth, device auth, an API key, or an access token piped over stdin.

Maturity: Stable

Remove stored authentication credentials.

Maturity: Stable

Manage Model Context Protocol servers (list, add, remove, authenticate).

Maturity: Stable

Install, list, and remove plugins from configured marketplace sources.

Maturity: Stable

Add, list, upgrade, or remove plugin marketplaces from Git or local sources.

Maturity: Stable

Queue a text message for an existing session by UUID or exact name.

Maturity: Stable

Run or manage remote control for the local app-server, or create a short-lived pairing code.

Maturity: Experimental

Continue a previous interactive session by ID or resume the most recent chat.

Maturity: Stable

Run a non-interactive review of uncommitted changes, a base branch diff, a commit, or custom review instructions.

Maturity: Stable

Run arbitrary commands inside Codex-provided macOS, Linux, or Windows sandboxes.

Maturity: Stable

Restore an archived interactive session by session ID or session name.

Maturity: Stable

Check for and apply a Codex CLI update when the installed release supports self-update.

Maturity: Stable

Persistently disable a feature flag in $CODEX_HOME/config.toml.

codex features disable <feature>

Persistently enable a feature flag in $CODEX_HOME/config.toml.

codex features enable <feature>

Show known feature flags, their maturity stage, and their effective state.

codex features list

Resume an exec session by ID or add --last to continue the most recent session from the current working directory. Add --all to consider sessions from any directory.

codex exec resume [SESSION_ID]

Print the active authentication mode and exit with 0 when logged in.

codex login status

Register a server using a stdio launcher command or a streamable HTTP URL. Supports --env KEY=VALUE for stdio transports.

add <name> -- <command...> | --url <value>

Show a specific server configuration. --json prints the raw config entry.

get <name> --json

List configured MCP servers. Add --json for machine-readable output.

list --json

Start an OAuth login for a streamable HTTP server (servers that support OAuth only).

login <name> --scopes scope1,scope2

Remove stored OAuth credentials for a streamable HTTP server.

logout <name>

Delete a stored MCP server definition.

remove <name>

Install a plugin from a configured marketplace. Use --marketplace or -m when the plugin argument omits @marketplace.

add <plugin[@marketplace]> [--marketplace, -m NAME] [--json]

List installed plugins. With --json, output has installed and available arrays; --available includes uninstalled marketplace plugins and requires --json.

list [--marketplace, -m NAME] [--available --json] [--json]

Remove an installed plugin from local config and cache. Use --json for automation-friendly output.

remove <plugin[@marketplace]> [--marketplace, -m NAME] [--json]

Install a plugin marketplace from GitHub shorthand, a Git URL, an SSH URL, or a local marketplace root directory. --sparse is supported only for Git sources and can be repeated.

add <source> [--ref REF] [--sparse PATH] [--json]

Show plugin marketplaces Codex is currently considering and the root path for each marketplace.

list [--json]

Remove a configured plugin marketplace.

remove <marketplace-name> [--json]

Refresh one configured Git marketplace, or all configured Git marketplaces when no name is provided.

upgrade [marketplace-name] [--json]

Submits a Codex cloud task directly from the terminal (the default codex cloud command opens an interactive picker).

List recent cloud chats with optional filtering and pagination.

Start the local app-server daemon with remote control enabled.

Stop the local app-server daemon started for remote control.

After the daemon is running, create and print a short-lived manual pairing code. With --json, the response includes pairingCode, manualPairingCode, environmentId, and expiresAt.

Evaluate one or more --rules files against a command and emit JSON showing the strictest decision and any matching rules. The execpolicy command is currently in preview.

[--pretty] --rules <path> -- <command...>

codex exec can resume sessions or fork them into new sessions; codex exec fork is listed among the commands that support --worktree (requires local execution).