codex-commands-cheat-sheet
OpenAI Codex CLI commands cheat sheet for developers: slash commands, flags, config, sandboxing, MCP, and workflows.
Install / Use
claude mcp add jqueryscript -- npx -y github:jqueryscript/codex-commands-cheat-sheetIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
AutomationSupported Platforms
Tags
Our assessment of codex-commands-cheat-sheet
codex-commands-cheat-sheet scores 76/100 on our quality scale, 2519th of 2,771 Automation skills we index.
Its MCP Server is 14 KB long, well organised into 12 sections with 1 code example: a thorough specification that gives an agent plenty to work with.
It has 3 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated 21 days ago, so codex-commands-cheat-sheet is actively maintained.
- Our last check on 2026-11-12 found the source still online.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 80/100, with 2 cautions from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
ReviewOur scan of the whole file found 1 pattern worth reviewing before you install codex-commands-cheat-sheet. An AI review of the same text found nothing harmful.
- mediumDisables the agent's permission promptsline 135
| `--dangerously-bypass-approvals-and-sandbox` | Disable approvals and sandboxing. |
AI review by kimi-k2.7-code on 2026-10-02. Automated pattern scan on 2026-10-02. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
codex-commands-cheat-sheet compared with similar skills
All 4 of these similar skills score higher than codex-commands-cheat-sheet; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| codex-commands-cheat-sheet (this skill)by jqueryscript | 76 | 3 | 21d ago | MCP Server |
| Agent-Reachby Panniantong | 100 | 113.3k | 12d ago | CLAUDE.md |
| hyperframesby heygen-com | 100 | 87.1k | today | CLAUDE.md |
| rufloby ruvnet | 100 | 82.1k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 80.2k | today | CLAUDE.md |
Frequently asked questions
- How do I install codex-commands-cheat-sheet?
- Run
claude mcp add jqueryscript -- npx -y github:jqueryscript/codex-commands-cheat-sheet. The install tabs above show the steps for each supported agent. - Which AI agents does codex-commands-cheat-sheet work with?
- It is written for Claude Code, Claude Desktop and OpenAI Codex, as a MCP Server file. Other agents that read the same format can often use it too.
- Is codex-commands-cheat-sheet safe to use?
- Our scan of the whole file found 1 pattern worth reviewing before you install codex-commands-cheat-sheet. An AI review of the same text found nothing harmful. It declares no license and scores 80/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is codex-commands-cheat-sheet still maintained?
- The repository was last updated 21 days ago, so codex-commands-cheat-sheet is actively maintained.
Skill content
View source on GitHubCodex Commands Cheat Sheet
OpenAI Codex CLI reference for commands, slash commands, flags, config, environment variables, MCP, and app-server APIs.
Last audited: August 21, 2026
CLI Commands
Use these from a terminal prompt before or instead of opening the interactive TUI.
| Command | Use |
|---|---|
| npm install -g @openai/codex | Install Codex CLI with npm. |
| brew install --cask codex | Install Codex CLI with Homebrew on macOS. |
| codex | Open the interactive TUI in the current project. |
| codex "Explain this codebase" | Open the TUI with an initial prompt. |
| codex login | Start the default ChatGPT sign-in flow. |
| codex login --device-auth | Use device-code auth for headless or remote environments. |
| printenv OPENAI_API_KEY \| codex login --with-api-key | Sign in with an API key from stdin. |
| codex login status | Check the active authentication mode. |
| codex logout | Remove stored Codex credentials. |
| codex update | Apply an update when the installed build supports self-update. |
| codex resume | Open a picker for saved sessions. |
| codex resume --last | Resume the most recent saved session. |
| codex resume <SESSION_ID> | Resume a specific saved session. |
| codex fork | Fork a previous session into a new thread. |
| codex archive | Archive a saved session. |
| codex remote-control pair | Print a short-lived manual pairing code for a running remote-control daemon. |
| codex unarchive | Restore an archived session. |
| codex delete | Permanently delete a saved session after confirmation. |
| codex exec "Task" | Run a non-interactive task. |
| codex exec - | Read the prompt from stdin. |
| codex exec resume --last "Task" | Continue the last non-interactive run. |
| codex exec fork | Fork a saved non-interactive session into a new session while preserving the original. |
| codex review | Run a non-interactive code review. |
| codex apply <TASK_ID> | Apply the latest diff from a Codex Cloud task. |
| codex doctor | Create a local diagnostic report. |
| codex app | Open Codex Desktop from the terminal. |
| codex app [PATH] | Launch Codex Desktop. macOS can open a workspace path; Windows prints the path to open. |
| codex app --download-url | Print the Codex Desktop download URL. |
| codex completion <shell> | Print shell completions for Bash, Zsh, Fish, PowerShell, or Elvish. |
Cloud, MCP, and Plugin CLI Commands
| Command | Use |
|---|---|
| codex cloud or codex cloud-tasks | Open a Codex Cloud task picker. |
| codex cloud exec --env <ENV_ID> [--attempts <1-4>] "Task" | Submit a cloud task directly with an optional retry limit. |
| codex cloud list [--limit <N>] [--cursor <CURSOR>] [--env <ENV_ID>] --json | List recent cloud tasks with JSON output and optional pagination or environment filtering. |
| codex cloud status <TASK_ID> | Legacy syntax. Use the cloud task picker or current cloud task commands. |
| codex cloud diff <TASK_ID> | Legacy syntax. Use the current cloud task workflow to inspect results. |
| codex cloud apply <TASK_ID> | Legacy syntax. Use codex apply <TASK_ID> for a task diff when supported. |
| codex mcp list | List configured MCP servers. |
| codex mcp get <name> | Show one MCP server configuration. |
| codex mcp add <name> -- <command...> | Add a stdio MCP server. |
| codex mcp add <name> --url https://... | Add a streamable HTTP MCP server. |
| codex mcp login <name> | Start OAuth login for an MCP server. |
| codex mcp logout <name> | Remove stored MCP OAuth credentials. |
| codex mcp remove <name> | Delete an MCP server definition. |
| codex mcp-server | Run Codex itself as an MCP server. |
| codex plugin list [--available] --json | List installed plugins or include available plugin metadata as JSON. |
| codex plugin add <PLUGIN[@MARKETPLACE]> --json | Add a plugin with structured output. |
| codex plugin remove --json | Remove a plugin with structured output. |
| codex plugin marketplace list --json | List marketplace sources as JSON. |
| codex plugin marketplace add <source> [--ref <REF>] [--sparse] --json | Add a plugin marketplace and optionally return JSON. |
| codex plugin marketplace remove <name> --json | Remove a plugin marketplace. |
| codex plugin marketplace upgrade [name] --json | Refresh Git-backed plugin marketplaces. |
TUI Shortcuts
These are typed inside the TUI composer but are not slash commands.
| Shortcut | Use |
|---|---|
| @ | Open the unified mentions menu for files, plugins, and skills. |
| Ctrl+R | Search prompt history. |
| Ctrl+O | Copy the latest completed output. |
Slash Commands
Use these only after codex opens the interactive TUI.
| Slash command | Use |
|---|---|
| /status | Check model, approval mode, roots, token use, cost estimate, and session details. |
| /usage | View token activity, rate limits, and available usage-reset credits. |
| /new [NAME] | Start a new conversation; an optional name helps find it later. |
| /clear [NAME] | Clear the terminal and start a fresh, optionally named chat. |
| /resume | Open the saved-session picker. |
| /fork | Fork the current conversation. |
| /archive | Archive the current session. |
| /delete | Permanently delete the current session after confirmation. |
| /side | Start a temporary side chat and return to the parent without closing it. |
| /compact | Summarize earlier turns to reduce context use. |
| /copy | Copy the latest completed response. |
| /export | Export the complete TUI conversation to Markdown, copy it, or save it to a file. |
| /import | Import supported setup, project files, recent chats, and other supported artifacts from Claude Code or Cursor. |
| /diff | Show current working tree changes. |
| /review | Review current changes for bugs and regressions. |
| /permissions | Change approval behavior. |
| /sandbox-add-read-dir C:\absolute\path | Grant sandbox read access to another Windows directory. |
| /mention src/file.ts | Attach a file or folder to the conversation. |
| /init | Create an AGENTS.md scaffold. |
| /model | Choose model and reasoning effort. |
| /fast on, /fast off, /fast status | Control Fast mode when supported. |
| /plan | Switch to plan mode. |
| /goal | Set or view a long-running goal. |
| /personality | Change response style when supported. |
| /experimental | Toggle experimental features. |
| /mcp | List MCP tools in the current session. |
| /apps | Browse apps and connectors. |
| /plugins | Browse categorized plugins, recommendations, and installed plugin state. |
| /app | Hand off the current CLI thread to Codex Desktop. |
| /statusline | Configure TUI footer fields. |
| /title | Configure terminal title fields. |
| /keymap | Remap TUI keyboard shortcuts. |
| /agent | Manage delegated agents when available. |
| /ps | List background terminals or running tasks. |
| /stop | Stop a running task. |
| /exit or /quit | Exit the TUI. |
| /logout | Sign out from inside the TUI. |
| /feedback | Open the feedback flow. |
| /approvals | Legacy alias. Prefer /permissions. |
| /clean | Alias for /stop. |
CLI Flags
Add these to codex, codex exec, or another subcommand when the command supports them.
| Flag | Use |
|---|---|
| --add-dir <path> | Grant access to another directory. |
| --ask-for-approval, -a <policy> | Set approval behavior for one run. |
| --cd, -C <path> | Set the working directory. |
| --config, -c key=value | Override config for one invocation. |
| --dangerously-bypass-approvals-and-sandbox | Disable approvals and sandboxing. |
| --yolo | Alias for bypassing approvals and sandboxing. |
| --disable <feature> | Disable a feature flag for one run. |
| --enable <feature> | Enable a feature flag for one run. |
| --image, -i <path> | Attach an image to the first prompt. |
| --help, -h | Print help. |
| --version, -V | Print the installed CLI version. |
| --model, -m <model> | Override the configured model. |
| --no-alt-screen | Disable alternate-screen TUI mode. |
| --oss | Use a local open source provider. |
| --local-provider <provider> | Select a local OSS provider. |
| --profile, -p <name> | Load a config profile. |
| --remote <ws://host:port> | Connect the TUI to a remote app server. |
| --remote-auth-token-env <ENV_VAR> | Send a bearer token for remote TUI auth. |
| --sandbox, -s <mode> | Set sandbox policy. |
| --search | Enable live web search. |
| --json | Print newline-delimited JSON events for codex exec. |
| --ephemeral | Avoid saving session rollout files. |
| --skip-git-repo-check | Run outside a Git repository. |
| --ignore-user-config | Ignore user config for one run. |
| --ignore-rules | Skip user and project execpolicy rules. |
| --color never | Control ANSI color output. |
| --output-last-message out.md | Save the final response to a file. |
| --output-schema schema.json | Validate the final response against a JSON Schema. |
| --full-auto | Deprecated shortcut. Prefer explicit sandbox and approval flags. |
| --experimental-json | Legacy alias for --json. |
Config Keys
Put these in ~/.codex/config.toml when you want persistent defaults.
| Config key | Use |
|---|---|
| model = "gpt-5.5" | Set the default model. |
| model_reasoning_effort = "medium" | Set default reasoning effort. |
| model_reasoning_summary = "auto" | Control reasoning summary detail. |
| model_verbosity = "medium" | Set GPT-5 Responses API verbosity. |
| model_provider = "openai" | Select the model provider. |
| oss_provider = "ollama" | Set the provider used by --oss. |
| review_model = "<model>" | Set the model used by /review. |
| sandbox_mode = "workspace-write" | Persist the sandbox policy. |
| sandbox_workspace_write.writable_roots = ["/path"] | Add writable roots in workspace-write mode. |
| sandbox_workspace_write.network_access = true | Allow outbound network in workspace-write mode. |
| approval_policy = "on-request" | Persist approval behavior. |
| history.persistence = "none" | Stop transcript persistence. |
| hide_agent_reasoning = true | Hide reasoning events in TUI and exec output. |
| mcp_servers.<id>.command = "node" | Define a stdio MCP launcher command. |
| mcp_servers.<id>.args = ["server.js"] | Define stdio MCP launcher arguments. |
| mcp_servers.<id>.env = { KEY = "VALUE" } | Set environment variables for a stdio MCP server. |
| mcp_servers.<id>.bearer_token_env_var = "TOKEN_ENV" | Read an HTTP bearer token from an environment variable. |
| mcp_servers.<id>.enabled = false | Disable a server without deleting it. |
| mcp_servers.<id>.enabled_tools = ["tool_name"] | Allow only selected MCP tools. |
| mcp_servers.<id>.disabled_tools = ["tool_name"] | Block selected MCP tools. |
| Hooks in config.toml | Run lifecycle hooks. |
Environment Variables
| Variable | Use |
|---|---|
| OPENAI_API_KEY | Store an OpenAI API key for API-key auth flows. |
| CODEX_API_KEY | Register remote execution setup for approved OpenAI hosts. |
| CODEX_HOME | Change where Codex stores config, auth, logs, and sessions. |
| CODEX_NON_INTERACTIVE=1 | Run supported install scripts without prompts. |
| CODEX_CA_CERTIFICATE | Point Codex at a custom CA bundle. |
| SSL_CERT_FILE | Fallback custom CA bundle path. |
| RUST_LOG | Control Rust logging verbosity. |
| CODEX_REMOTE_AUTH_TOKEN | Example bearer-token variable for remote TUI auth. |
| Custom provider env_key | Supply a provider-specific API key. |
Experimental CLI Commands
| Command | Use |
|---|---|
| codex app-server [--stdio|--listen <URL>] | Start the experimental app-server. Stdio JSONL is the default; use --listen ws://... or --listen unix://... for other transports. |
| codex remote-control pair | Print a short-lived manual pairing code; add --json for machine-readable output. |
| `codex rem
Truncated for display — read the full file on GitHub.
Related Skills
Agent-Reach
113.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
hyperframes
87.1kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
ruflo
82.1k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
80.2kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
