1# Glossary – Codex1# Glossary
2 2
3Use this glossary as a quick reference for Codex terms across the app, CLI, IDE extension, cloud, SDK, and related integrations.3Use this glossary as a quick reference for Codex terms across the app, CLI, IDE extension, cloud, SDK, and related integrations.
4 4
5| Term | Definition | Applies to |5<GlossaryTable
6| --- | --- | --- |6 client:load
7| [Agent](/codex) | The Codex worker that reasons over context, uses tools, and completes a task. | App, CLI, IDE extension, Cloud |7 searchPlaceholder="Filter by term, definition, or surface"
8| [AGENTS.md](https://developers.openai.com/codex/guides/agents-md) | Repository or user guidance file that gives Codex persistent instructions. | App, CLI, IDE extension, Cloud |8 searchLabel="Search glossary terms"
9| [Analytics dashboard](https://developers.openai.com/codex/enterprise/governance#analytics-dashboard) | Admin view for Codex usage, adoption, and code review metrics. | Enterprise |9 emptyStateMessage="No glossary terms match your search."
10| [API key sign-in](https://developers.openai.com/codex/auth#sign-in-with-an-api-key) | Authentication using an OpenAI API key. | App, CLI, IDE extension |10 maxVisibleEntries={100}
11| [Approval policy](https://developers.openai.com/codex/agent-approvals-security#sandbox-and-approvals) | Rules for when Codex must ask before taking an action. | App, CLI, IDE extension |11 options={[
12| [Approval request](https://developers.openai.com/codex/agent-approvals-security#automatic-approval-reviews) | Codex asking to allow a restricted action. | App, CLI, IDE extension |12 {
13| [Apps (connectors)](https://developers.openai.com/codex/plugins) | Integration that lets Codex access external services. Available through plugins; also called connectors. | App, CLI, IDE extension |13 key: "Agent",
14| [Appshot](https://developers.openai.com/codex/appshots) | Snapshot of the frontmost app window sent to a Codex thread. | App |14 href: "/codex",
15| [Auth cache](https://developers.openai.com/codex/auth#login-caching) | Locally stored login credentials reused by Codex. | App, CLI, IDE extension |15 appliesTo: "App, CLI, IDE extension, Cloud",
16| [Automatic approval review](https://developers.openai.com/codex/agent-approvals-security#automatic-approval-reviews) | Model-based review of eligible approval requests before they proceed. | App, CLI, IDE extension |16 description:
17| [Automation](https://developers.openai.com/codex/app/automations) | A scheduled or recurring Codex task. | App |17 "The Codex worker that reasons over context, uses tools, and completes a task.",
18| [Automation run](https://developers.openai.com/codex/app/automations#managing-tasks) | One execution of a scheduled automation that may report findings or archive itself. | App |18 },
19| [Browser use](https://developers.openai.com/codex/app/browser#browser-use) | App capability that lets Codex operate the in-app browser directly. | App |19 {
20| [Chat](https://developers.openai.com/codex/app/features#chats) | A Codex conversation not tied to a project. | App |20 key: "AGENTS.md",
21| [ChatGPT sign-in](https://developers.openai.com/codex/auth#sign-in-with-chatgpt) | Authentication using a ChatGPT account and workspace permissions. | App, CLI, IDE extension, Cloud |21 href: "/codex/guides/agents-md",
22| [Chronicle](https://developers.openai.com/codex/memories/chronicle) | Opt-in feature that builds memories from recent screen context. | App |22 appliesTo: "App, CLI, IDE extension, Cloud",
23| [Cloud](https://developers.openai.com/codex/cloud) | Mode where Codex works remotely in an OpenAI-managed environment. | App, IDE extension, Web |23 description:
24| [Cloud environment](https://developers.openai.com/codex/cloud/environments) | Configured container setup used for Codex cloud tasks. | Cloud |24 "Repository or user guidance file that gives Codex persistent instructions.",
25| [Cloud task](https://developers.openai.com/codex/cloud/environments#how-codex-cloud-tasks-run) | A remotely executed Codex task that runs in a cloud environment. | Cloud |25 },
26| [Cloud thread](https://developers.openai.com/codex/prompting#threads) | A thread that runs in a Codex cloud environment. | Cloud |26 {
27| [Codex](/codex) | OpenAI's coding agent for software development tasks. | App, CLI, IDE extension, Web, Cloud, SDK |27 key: "Analytics dashboard",
28| [Codex app](https://developers.openai.com/codex/app) | Desktop app for running Codex threads in parallel, with built-in worktree support, automations, and Git functionality. | Desktop |28 href: "/codex/enterprise/governance#analytics-dashboard",
29| [Codex app-server](https://developers.openai.com/codex/app-server) | Local JSON-RPC server for embedding Codex threads, turns, approvals, history, and streamed events in custom clients. | App, IDE extension, SDK |29 appliesTo: "Enterprise",
30| [Codex CLI](https://developers.openai.com/codex/cli) | Terminal client for running Codex interactively or in scripts. | Terminal |30 description:
31| [Codex cloud](https://developers.openai.com/codex/cloud) | OpenAI-managed execution environment where Codex can work on repository tasks remotely. | Web, App, IDE extension |31 "Admin view for Codex usage, adoption, and code review metrics.",
32| [codex exec](https://developers.openai.com/codex/noninteractive) | CLI command for running Codex non-interactively from scripts or CI. | CLI |32 },
33| [Codex IDE extension](https://developers.openai.com/codex/ide) | Editor integration for using Codex inside IDEs like VS Code, JetBrains IDEs, Cursor, and Windsurf. | IDE |33 {
34| [Codex SDK](https://developers.openai.com/codex/sdk) | Programmatic interface for building Codex-powered workflows or integrations. | SDK |34 key: "API key sign-in",
35| [Codex web](https://developers.openai.com/codex/cloud) | Browser-based Codex surface for delegating cloud tasks. | Browser |35 href: "/codex/auth#sign-in-with-an-api-key",
36| [Codex-managed worktree](https://developers.openai.com/codex/app/worktrees#codex-managed-and-permanent-worktrees) | A temporary worktree Codex creates and manages for a thread. | App |36 appliesTo: "App, CLI, IDE extension",
37| [Compaction](https://developers.openai.com/codex/prompting#context) | Summarizing older context so long-running work can continue. | App, CLI, IDE extension, Cloud |37 description: "Authentication using an OpenAI API key.",
38| [Compliance API](https://developers.openai.com/codex/enterprise/governance#compliance-api) | API for exporting Codex activity and audit metadata. | Enterprise |38 },
39| [Computer use](https://developers.openai.com/codex/app/computer-use) | App capability that lets Codex interact with desktop applications through the UI. | App |39 {
40| [config.toml](https://developers.openai.com/codex/config-reference#configtoml) | Local Codex configuration files. | App, CLI, IDE extension |40 key: "Approval policy",
41| [Connected host](https://developers.openai.com/codex/remote-connections#what-comes-from-the-connected-host) | Computer or development environment that provides files, tools, and shell access for remote Codex work. | App, Mobile |41 href: "/codex/agent-approvals-security#sandbox-and-approvals",
42| [Connector](https://developers.openai.com/codex/plugins) | App integration that lets Codex access external services. Available through plugins; also called apps. | App, Cloud |42 appliesTo: "App, CLI, IDE extension",
43| [Container cache](https://developers.openai.com/codex/cloud/environments#container-caching) | Saved cloud container state reused to speed up future tasks. | Cloud |43 description: "Rules for when Codex must ask before taking an action.",
44| [Context](https://developers.openai.com/codex/prompting#context) | Information Codex can use while working, such as files, prior messages, tool output, and instructions. | App, CLI, IDE extension, Cloud, SDK |44 },
45| [Context window](https://developers.openai.com/api/docs/guides/conversation-state#managing-the-context-window) | The maximum amount of information the model can consider at once. | App, CLI, IDE extension, Cloud, SDK |45 {
46| [Custom agent](https://developers.openai.com/codex/subagents#custom-agents) | User-defined agent role with its own instructions and settings. | App, CLI |46 key: "Approval request",
47| [Deny-read rule](https://developers.openai.com/codex/permissions#deny-reads-with-exact-paths-or-globs) | Filesystem permission rule that prevents Codex from reading sensitive paths or glob matches. | App, CLI, IDE extension, Enterprise |47 href: "/codex/agent-approvals-security#automatic-approval-reviews",
48| [Diff](https://developers.openai.com/codex/app/review#what-changes-it-shows) | Set of Git file changes shown for inspection, comments, staging, or reverting. | App, Git, Review |48 appliesTo: "App, CLI, IDE extension",
49| [Domain allowlist](https://developers.openai.com/codex/cloud/internet-access#domain-allowlist) | Set of domains Codex cloud can reach when agent internet access is enabled. | Cloud |49 description: "Codex asking to allow a restricted action.",
50| [Environment (local)](https://developers.openai.com/codex/app/local-environments) | App configuration to tell Codex how to set up worktrees for a project. | App, Worktree |50 },
51| [Environment variable](https://developers.openai.com/codex/cloud/environments#environment-variables-and-secrets) | Runtime configuration value available during task execution. | Cloud, CLI, IDE extension |51 {
52| [Ephemeral session](https://developers.openai.com/codex/noninteractive#basic-usage) | Non-interactive run that skips saving session state after it completes. | CLI |52 key: "Apps (connectors)",
53| [Fast mode](https://developers.openai.com/codex/speed#fast-mode) | Speed setting that makes supported models respond faster at a higher credit cost. | CLI, IDE extension |53 href: "/codex/plugins",
54| [Filesystem permission](https://developers.openai.com/codex/permissions#filesystem-permissions) | Permission profile rule that grants or denies read and write access to paths. | App, CLI, IDE extension |54 appliesTo: "App, CLI, IDE extension",
55| [Finding](https://developers.openai.com/codex/app/automations#managing-tasks) | A notable result or issue surfaced by an automation. | App |55 description:
56| [Full access](https://developers.openai.com/codex/concepts/sandboxing#configure-defaults) | Mode where Codex runs without normal sandbox restrictions. | App, CLI, IDE extension |56 "Integration that lets Codex access external services. Available through plugins; also called connectors.",
57| [Git worktree](https://developers.openai.com/codex/app/worktrees#whats-a-worktree) | A second checkout of the same repository for parallel branch work. | App, Git |57 },
58| [Handoff](https://developers.openai.com/codex/app/worktrees#working-between-local-and-worktree) | Moving a thread and its work between Local and Worktree. | App |58 {
59| [Heartbeat](https://developers.openai.com/codex/app/automations#thread-automations) | A recurring thread wake-up that returns Codex to the same conversation on a schedule. Also called a thread automation. | App |59 key: "Appshot",
60| [Hook](https://developers.openai.com/codex/hooks) | A lifecycle handler that runs when a Codex event matches, such as tool use, permission requests, or when a turn stops. | App, CLI, IDE extension |60 href: "/codex/appshots",
61| [Hook event](https://developers.openai.com/codex/hooks#config-shape) | Lifecycle point where configured hook handlers can run. | App, CLI, IDE extension |61 appliesTo: "App",
62| [Hunk](https://developers.openai.com/codex/app/review#staging-and-reverting-files) | Contiguous section of a diff that can be staged, unstaged, or reverted independently. | App, Git, Review |62 description:
63| [Inline comment](https://developers.openai.com/codex/app/review#inline-comments-for-feedback) | Line-specific feedback attached to a diff. | App |63 "Snapshot of the frontmost app window sent to a Codex thread.",
64| [Live web search](https://developers.openai.com/codex/config-basic#web-search-mode) | Real-time web lookup for current information. | App, CLI, IDE extension |64 },
65| [Local](https://developers.openai.com/codex/app/worktrees#working-between-local-and-worktree) | Mode where Codex works on the user's computer. | App, CLI, IDE extension |65 {
66| [Local thread](https://developers.openai.com/codex/prompting#threads) | A thread that runs on the user's machine. | App, CLI, IDE extension |66 key: "Auth cache",
67| [Maintenance script](https://developers.openai.com/codex/cloud/environments#container-caching) | Optional script run when a cached cloud container resumes. | Cloud |67 href: "/codex/auth#login-caching",
68| [Managed configuration](https://developers.openai.com/codex/enterprise/managed-configuration) | Organization-controlled Codex defaults and restrictions. | Enterprise |68 appliesTo: "App, CLI, IDE extension",
69| [MCP](https://developers.openai.com/codex/mcp) | Model Context Protocol, a standard for connecting Codex to external tools and context. | App, CLI, IDE extension |69 description: "Locally stored login credentials reused by Codex.",
70| [MCP resource](https://developers.openai.com/codex/mcp#supported-mcp-features) | Readable context exposed by an MCP server for Codex to inspect. | App, CLI, IDE extension |70 },
71| [MCP server](https://developers.openai.com/codex/mcp#supported-mcp-features) | External tool or context provider exposed through MCP. | App, CLI, IDE extension |71 {
72| [MCP tool](https://developers.openai.com/codex/mcp#supported-mcp-features) | Action exposed by an MCP server that Codex can call during a task. | App, CLI, IDE extension |72 key: "Automatic approval review",
73| [MDM](https://developers.openai.com/codex/enterprise/managed-configuration#macos-managed-preferences-mdm) | Mobile device management tooling for distributing device profiles and managed Codex settings. | Enterprise |73 href: "/codex/agent-approvals-security#automatic-approval-reviews",
74| [Memories](https://developers.openai.com/codex/memories) | Locally stored context Codex can reuse across sessions. | App, CLI, IDE extension |74 appliesTo: "App, CLI, IDE extension",
75| [Model](https://developers.openai.com/codex/models) | The AI model Codex uses for reasoning and tool work. | App, CLI, IDE extension, Cloud, SDK |75 description:
76| [Network access](https://developers.openai.com/codex/agent-approvals-security#network-access-) | Permission for commands or environments to reach the internet. | App, CLI, IDE extension, Cloud |76 "Model-based review of eligible approval requests before they proceed.",
77| [Network policy](https://developers.openai.com/codex/agent-approvals-security#network-policy) | Domain-based allow and deny rules that constrain sandboxed outbound network traffic. | App, CLI, IDE extension |77 },
78| [Non-interactive mode](https://developers.openai.com/codex/noninteractive) | CLI mode for running Codex from scripts or CI. | CLI |78 {
79| [Output schema](https://developers.openai.com/codex/noninteractive#create-structured-outputs-with-a-schema) | JSON Schema passed to `codex exec` to constrain the final response. | CLI |79 key: "Automation",
80| [Permanent worktree](https://developers.openai.com/codex/app/worktrees#codex-managed-and-permanent-worktrees) | A long-lived worktree kept as its own project. | App |80 href: "/codex/app/automations",
81| [Permission profile](https://developers.openai.com/codex/permissions#define-and-select-a-profile) | Named least-privilege policy that combines filesystem and network rules for local command execution. | App, CLI, IDE extension |81 appliesTo: "App",
82| [Plan](https://developers.openai.com/codex/learn/best-practices#plan-first-for-difficult-tasks) | Codex's proposed or tracked steps for completing a task. | App, CLI, IDE extension, Cloud |82 description: "A scheduled or recurring Codex task.",
83| [Plugin](https://developers.openai.com/codex/plugins) | Installable bundle that can distribute skills, tools, and integrations. | App, CLI, IDE extension |83 },
84| [Plugin manifest](https://developers.openai.com/codex/plugins/build#plugin-structure) | Plugin metadata file that identifies a plugin and points to bundled skills, apps, MCP servers, hooks, and metadata. | App, CLI, IDE extension, Plugins |84 {
85| [Prefix rule](https://developers.openai.com/codex/rules#understand-the-rules-language) | Command-rule pattern that allows, prompts for, or forbids matching command prefixes. | App, CLI, IDE extension, Enterprise |85 key: "Automation run",
86| [Profile](https://developers.openai.com/codex/config-advanced#profiles) | Named configuration preset for Codex. | CLI, IDE extension |86 href: "/codex/app/automations#managing-tasks",
87| [Progressive disclosure](https://developers.openai.com/codex/skills) | Loading skill details only when needed to preserve context. | App, CLI, IDE extension |87 appliesTo: "App",
88| [Project](https://developers.openai.com/codex/app/features#multitask-across-projects) | A selected codebase or folder Codex works in. | App |88 description:
89| [Prompt](https://developers.openai.com/codex/prompting) | The user instruction or request sent to Codex. | App, CLI, IDE extension, Cloud, SDK |89 "One execution of a scheduled automation that may report findings or archive itself.",
90| [Pull request review](https://developers.openai.com/codex/app/review#pull-request-reviews) | Codex review of changes or feedback on a pull request. | App, CLI, GitHub |90 },
91| [RBAC](https://developers.openai.com/codex/enterprise/admin-setup#step-2-set-up-custom-roles-rbac) | Role-based access control for workspace permissions. | Enterprise |91 {
92| [Read-only mode](https://developers.openai.com/codex/concepts/sandboxing) | Mode where Codex can inspect but not modify without approval. | App, CLI, IDE extension |92 key: "Browser use",
93| [Reasoning effort](https://developers.openai.com/codex/config-basic#reasoning-effort) | Setting that controls how much reasoning budget a model uses. | App, CLI, IDE extension, SDK |93 href: "/codex/app/browser#browser-use",
94| [Remote connection](https://developers.openai.com/codex/remote-connections) | Connection that lets Codex work from another device using a connected host. | App, Mobile |94 appliesTo: "App",
95| [requirements.toml](https://developers.openai.com/codex/config-reference#requirementstoml) | Admin-enforced requirements file for managed Codex setups. | Enterprise |95 description:
96| [Review pane](https://developers.openai.com/codex/app/review) | App view for inspecting diffs, comments, and Git changes. | App |96 "App capability that lets Codex operate the in-app browser directly.",
97| [Rules](https://developers.openai.com/codex/rules) | Policies that allow, prompt for, or deny command prefixes or permission exceptions. | App, CLI, IDE extension |97 },
98| [Sandbox](https://developers.openai.com/codex/concepts/sandboxing) | Enforced boundary limiting what Codex commands can access or modify. | App, CLI, IDE extension |98 {
99| [Sandbox mode](https://developers.openai.com/codex/config-basic#sandbox-level) | Configuration that defines Codex's filesystem and network limits. | App, CLI, IDE extension |99 key: "Chat",
100| [Sandbox preset](https://developers.openai.com/codex/sdk#sandbox-presets) | SDK shorthand for common sandbox policies such as read-only, workspace-write, or full access. | SDK |100 href: "/codex/app/features#chats",
101| [Schedule](https://developers.openai.com/codex/app/automations) | The timing rule for an automation. | App |101 appliesTo: "App",
102| [Secret](https://developers.openai.com/codex/cloud/environments#environment-variables-and-secrets) | Encrypted value available to setup scripts but removed before the agent phase. | Cloud |102 description: "A Codex conversation not tied to a project.",
103| [Setup script](https://developers.openai.com/codex/app/local-environments#setup-scripts) | Script run before the agent starts to install dependencies or prepare tools. | App worktrees |103 },
104| [Skill](https://developers.openai.com/codex/skills) | Reusable workflow package with instructions and optional scripts or references. | App, CLI, IDE extension |104 {
105| [Skill invocation](https://developers.openai.com/codex/skills#how-codex-uses-skills) | Explicit or implicit activation of a skill. | App, CLI, IDE extension |105 key: "ChatGPT sign-in",
106| [Slash command](https://developers.openai.com/codex/cli/slash-commands) | Command entered with a leading slash to control or inspect a Codex CLI session. | CLI |106 href: "/codex/auth#sign-in-with-chatgpt",
107| [Standalone automation](https://developers.openai.com/codex/app/automations) | Independent scheduled run that reports separate findings. | App |107 appliesTo: "App, CLI, IDE extension, Cloud",
108| [STDIO MCP server](https://developers.openai.com/codex/mcp#stdio-servers) | MCP server launched as a local process by a configured command and arguments. | CLI, IDE extension |108 description:
109| [Streamable HTTP MCP server](https://developers.openai.com/codex/mcp#streamable-http-servers) | MCP server reached over HTTP, optionally with bearer token or OAuth authentication. | CLI, IDE extension |109 "Authentication using a ChatGPT account and workspace permissions.",
110| [Subagent](https://developers.openai.com/codex/concepts/subagents) | Specialized child agent spawned to work on part of a task. | App, CLI |110 },
111| [Subagent workflow](https://developers.openai.com/codex/concepts/subagents#core-terms) | Workflow where Codex runs delegated agents in parallel and combines their results. | App, CLI |111 {
112| [Task](https://developers.openai.com/codex/app/automations#managing-tasks) | The unit of work Codex is asked to complete. | App, CLI, IDE extension, Cloud, SDK |112 key: "Chronicle",
113| [Thread](https://developers.openai.com/codex/prompting#threads) | A single Codex session containing prompts, model output, and tool activity. | App, CLI, IDE extension, Cloud, SDK |113 href: "/codex/memories/chronicle",
114| [Thread automation](https://developers.openai.com/codex/app/automations#thread-automations) | Recurring wake-up attached to an existing thread. Also called a heartbeat. | App |114 appliesTo: "App",
115| [Thread fork](https://developers.openai.com/codex/app-server#start-or-resume-a-thread) | New thread branched from the stored history of an existing thread. | App-server, SDK |115 description:
116| [Turn](https://developers.openai.com/codex/app-server#core-primitives) | One exchange in a thread, usually a user prompt plus Codex's response and actions. | App, CLI, IDE extension, Cloud, SDK |116 "Opt-in feature that builds memories from recent screen context.",
117| [Universal image](https://developers.openai.com/codex/cloud/environments#default-universal-image) | Default Codex cloud container image with common tools preinstalled. | Cloud |117 },
118| [Web search cache](https://developers.openai.com/codex/config-basic#web-search-mode) | Pre-indexed search results Codex can use without live browsing. | App, CLI, IDE extension |118 {
119| [Worktree](https://developers.openai.com/codex/app/worktrees) | Mode where Codex isolates changes in a separate Git worktree. | App |119 key: "Cloud",
120| [Writable roots](https://developers.openai.com/codex/agent-approvals-security#protected-paths-in-writable-roots) | Directories Codex is allowed to modify. | App, CLI, IDE extension |120 href: "/codex/cloud",
121 121 appliesTo: "App, IDE extension, Web",
122Term122 description:
123 123 "Mode where Codex works remotely in an OpenAI-managed environment.",
124[Agent](/codex)124 },
125 125 {
126Definition126 key: "Cloud environment",
127 127 href: "/codex/cloud/environments",
128The Codex worker that reasons over context, uses tools, and completes a task.128 appliesTo: "Cloud",
129 129 description: "Configured container setup used for Codex cloud tasks.",
130Applies to130 },
131 131 {
132App, CLI, IDE extension, Cloud132 key: "Cloud task",
133 133 href: "/codex/cloud/environments#how-codex-cloud-tasks-run",
134Term134 appliesTo: "Cloud",
135 135 description:
136[AGENTS.md](https://developers.openai.com/codex/guides/agents-md)136 "A remotely executed Codex task that runs in a cloud environment.",
137 137 },
138Definition138 {
139 139 key: "Cloud thread",
140Repository or user guidance file that gives Codex persistent instructions.140 href: "/codex/prompting#threads",
141 141 appliesTo: "Cloud",
142Applies to142 description: "A thread that runs in a Codex cloud environment.",
143 143 },
144App, CLI, IDE extension, Cloud144 {
145 145 key: "Codex",
146Term146 href: "/codex",
147 147 appliesTo: "App, CLI, IDE extension, Web, Cloud, SDK",
148[Analytics dashboard](https://developers.openai.com/codex/enterprise/governance#analytics-dashboard)148 description: "OpenAI's coding agent for software development tasks.",
149 149 },
150Definition150 {
151 151 key: "Codex app",
152Admin view for Codex usage, adoption, and code review metrics.152 href: "/codex/app",
153 153 appliesTo: "Desktop",
154Applies to154 description:
155 155 "Desktop app for running Codex threads in parallel, with built-in worktree support, automations, and Git functionality.",
156Enterprise156 },
157 157 {
158Term158 key: "Codex app-server",
159 159 href: "/codex/app-server",
160[API key sign-in](https://developers.openai.com/codex/auth#sign-in-with-an-api-key)160 appliesTo: "App, IDE extension, SDK",
161 161 description:
162Definition162 "Local JSON-RPC server for embedding Codex threads, turns, approvals, history, and streamed events in custom clients.",
163 163 },
164Authentication using an OpenAI API key.164 {
165 165 key: "Codex CLI",
166Applies to166 href: "/codex/cli",
167 167 appliesTo: "Terminal",
168App, CLI, IDE extension168 description:
169 169 "Terminal client for running Codex interactively or in scripts.",
170Term170 },
171 171 {
172[Approval policy](https://developers.openai.com/codex/agent-approvals-security#sandbox-and-approvals)172 key: "Codex cloud",
173 173 href: "/codex/cloud",
174Definition174 appliesTo: "Web, App, IDE extension",
175 175 description:
176Rules for when Codex must ask before taking an action.176 "OpenAI-managed execution environment where Codex can work on repository tasks remotely.",
177 177 },
178Applies to178 {
179 179 key: "codex exec",
180App, CLI, IDE extension180 href: "/codex/noninteractive",
181 181 appliesTo: "CLI",
182Term182 description:
183 183 "CLI command for running Codex non-interactively from scripts or CI.",
184[Approval request](https://developers.openai.com/codex/agent-approvals-security#automatic-approval-reviews)184 },
185 185 {
186Definition186 key: "Codex IDE extension",
187 187 href: "/codex/ide",
188Codex asking to allow a restricted action.188 appliesTo: "IDE",
189 189 description:
190Applies to190 "Editor integration for using Codex inside IDEs like VS Code, JetBrains IDEs, Cursor, and Windsurf.",
191 191 },
192App, CLI, IDE extension192 {
193 193 key: "Codex SDK",
194Term194 href: "/codex/sdk",
195 195 appliesTo: "SDK",
196[Apps (connectors)](https://developers.openai.com/codex/plugins)196 description:
197 197 "Programmatic interface for building Codex-powered workflows or integrations.",
198Definition198 },
199 199 {
200Integration that lets Codex access external services. Available through plugins; also called connectors.200 key: "Codex web",
201 201 href: "/codex/cloud",
202Applies to202 appliesTo: "Browser",
203 203 description: "Browser-based Codex surface for delegating cloud tasks.",
204App, CLI, IDE extension204 },
205 205 {
206Term206 key: "Codex-managed worktree",
207 207 href: "/codex/app/worktrees#codex-managed-and-permanent-worktrees",
208[Appshot](https://developers.openai.com/codex/appshots)208 appliesTo: "App",
209 209 description:
210Definition210 "A temporary worktree Codex creates and manages for a thread.",
211 211 },
212Snapshot of the frontmost app window sent to a Codex thread.212 {
213 213 key: "Compaction",
214Applies to214 href: "/codex/prompting#context",
215 215 appliesTo: "App, CLI, IDE extension, Cloud",
216App216 description:
217 217 "Summarizing older context so long-running work can continue.",
218Term218 },
219 219 {
220[Auth cache](https://developers.openai.com/codex/auth#login-caching)220 key: "Compliance API",
221 221 href: "/codex/enterprise/governance#compliance-api",
222Definition222 appliesTo: "Enterprise",
223 223 description: "API for exporting Codex activity and audit metadata.",
224Locally stored login credentials reused by Codex.224 },
225 225 {
226Applies to226 key: "Computer use",
227 227 href: "/codex/app/computer-use",
228App, CLI, IDE extension228 appliesTo: "App",
229 229 description:
230Term230 "App capability that lets Codex interact with desktop applications through the UI.",
231 231 },
232[Automatic approval review](https://developers.openai.com/codex/agent-approvals-security#automatic-approval-reviews)232 {
233 233 key: "config.toml",
234Definition234 href: "/codex/config-reference#configtoml",
235 235 appliesTo: "App, CLI, IDE extension",
236Model-based review of eligible approval requests before they proceed.236 description: "Local Codex configuration files.",
237 237 },
238Applies to238 {
239 239 key: "Connected host",
240App, CLI, IDE extension240 href: "/codex/remote-connections#what-comes-from-the-connected-host",
241 241 appliesTo: "App, Mobile",
242Term242 description:
243 243 "Computer or development environment that provides files, tools, and shell access for remote Codex work.",
244[Automation](https://developers.openai.com/codex/app/automations)244 },
245 245 {
246Definition246 key: "Connector",
247 247 href: "/codex/plugins",
248A scheduled or recurring Codex task.248 appliesTo: "App, Cloud",
249 249 description:
250Applies to250 "App integration that lets Codex access external services. Available through plugins; also called apps.",
251 251 },
252App252 {
253 253 key: "Container cache",
254Term254 href: "/codex/cloud/environments#container-caching",
255 255 appliesTo: "Cloud",
256[Automation run](https://developers.openai.com/codex/app/automations#managing-tasks)256 description:
257 257 "Saved cloud container state reused to speed up future tasks.",
258Definition258 },
259 259 {
260One execution of a scheduled automation that may report findings or archive itself.260 key: "Context",
261 261 href: "/codex/prompting#context",
262Applies to262 appliesTo: "App, CLI, IDE extension, Cloud, SDK",
263 263 description:
264App264 "Information Codex can use while working, such as files, prior messages, tool output, and instructions.",
265 265 },
266Term266 {
267 267 key: "Context window",
268[Browser use](https://developers.openai.com/codex/app/browser#browser-use)268 href: "/api/docs/guides/conversation-state#managing-the-context-window",
269 269 appliesTo: "App, CLI, IDE extension, Cloud, SDK",
270Definition270 description:
271 271 "The maximum amount of information the model can consider at once.",
272App capability that lets Codex operate the in-app browser directly.272 },
273 273 {
274Applies to274 key: "Custom agent",
275 275 href: "/codex/subagents#custom-agents",
276App276 appliesTo: "App, CLI",
277 277 description:
278Term278 "User-defined agent role with its own instructions and settings.",
279 279 },
280[Chat](https://developers.openai.com/codex/app/features#chats)280 {
281 281 key: "Deny-read rule",
282Definition282 href: "/codex/permissions#deny-reads-with-exact-paths-or-globs",
283 283 appliesTo: "App, CLI, IDE extension, Enterprise",
284A Codex conversation not tied to a project.284 description:
285 285 "Filesystem permission rule that prevents Codex from reading sensitive paths or glob matches.",
286Applies to286 },
287 287 {
288App288 key: "Diff",
289 289 href: "/codex/app/review#what-changes-it-shows",
290Term290 appliesTo: "App, Git, Review",
291 291 description:
292[ChatGPT sign-in](https://developers.openai.com/codex/auth#sign-in-with-chatgpt)292 "Set of Git file changes shown for inspection, comments, staging, or reverting.",
293 293 },
294Definition294 {
295 295 key: "Domain allowlist",
296Authentication using a ChatGPT account and workspace permissions.296 href: "/codex/cloud/internet-access#domain-allowlist",
297 297 appliesTo: "Cloud",
298Applies to298 description:
299 299 "Set of domains Codex cloud can reach when agent internet access is enabled.",
300App, CLI, IDE extension, Cloud300 },
301 301 {
302Term302 key: "Environment (local)",
303 303 href: "/codex/app/local-environments",
304[Chronicle](https://developers.openai.com/codex/memories/chronicle)304 appliesTo: "App, Worktree",
305 305 description:
306Definition306 "App configuration to tell Codex how to set up worktrees for a project.",
307 307 },
308Opt-in feature that builds memories from recent screen context.308 {
309 309 key: "Environment variable",
310Applies to310 href: "/codex/cloud/environments#environment-variables-and-secrets",
311 311 appliesTo: "Cloud, CLI, IDE extension",
312App312 description:
313 313 "Runtime configuration value available during task execution.",
314Term314 },
315 315 {
316[Cloud](https://developers.openai.com/codex/cloud)316 key: "Ephemeral session",
317 317 href: "/codex/noninteractive#basic-usage",
318Definition318 appliesTo: "CLI",
319 319 description:
320Mode where Codex works remotely in an OpenAI-managed environment.320 "Non-interactive run that skips saving session state after it completes.",
321 321 },
322Applies to322 {
323 323 key: "Fast mode",
324App, IDE extension, Web324 href: "/codex/speed#fast-mode",
325 325 appliesTo: "CLI, IDE extension",
326Term326 description:
327 327 "Speed setting that makes supported models respond faster at a higher credit cost.",
328[Cloud environment](https://developers.openai.com/codex/cloud/environments)328 },
329 329 {
330Definition330 key: "Filesystem permission",
331 331 href: "/codex/permissions#filesystem-permissions",
332Configured container setup used for Codex cloud tasks.332 appliesTo: "App, CLI, IDE extension",
333 333 description:
334Applies to334 "Permission profile rule that grants or denies read and write access to paths.",
335 335 },
336Cloud336 {
337 337 key: "Finding",
338Term338 href: "/codex/app/automations#managing-tasks",
339 339 appliesTo: "App",
340[Cloud task](https://developers.openai.com/codex/cloud/environments#how-codex-cloud-tasks-run)340 description: "A notable result or issue surfaced by an automation.",
341 341 },
342Definition342 {
343 343 key: "Full access",
344A remotely executed Codex task that runs in a cloud environment.344 href: "/codex/concepts/sandboxing#configure-defaults",
345 345 appliesTo: "App, CLI, IDE extension",
346Applies to346 description: "Mode where Codex runs without normal sandbox restrictions.",
347 347 },
348Cloud348 {
349 349 key: "Git worktree",
350Term350 href: "/codex/app/worktrees#whats-a-worktree",
351 351 appliesTo: "App, Git",
352[Cloud thread](https://developers.openai.com/codex/prompting#threads)352 description:
353 353 "A second checkout of the same repository for parallel branch work.",
354Definition354 },
355 355 {
356A thread that runs in a Codex cloud environment.356 key: "Handoff",
357 357 href: "/codex/app/worktrees#working-between-local-and-worktree",
358Applies to358 appliesTo: "App",
359 359 description: "Moving a thread and its work between Local and Worktree.",
360Cloud360 },
361 361 {
362Term362 key: "Heartbeat",
363 363 href: "/codex/app/automations#thread-automations",
364[Codex](/codex)364 appliesTo: "App",
365 365 description:
366Definition366 "A recurring thread wake-up that returns Codex to the same conversation on a schedule. Also called a thread automation.",
367 367 },
368OpenAI's coding agent for software development tasks.368 {
369 369 key: "Hook",
370Applies to370 href: "/codex/hooks",
371 371 appliesTo: "App, CLI, IDE extension",
372App, CLI, IDE extension, Web, Cloud, SDK372 description:
373 373 "A lifecycle handler that runs when a Codex event matches, such as tool use, permission requests, or when a turn stops.",
374Term374 },
375 375 {
376[Codex app](https://developers.openai.com/codex/app)376 key: "Hook event",
377 377 href: "/codex/hooks#config-shape",
378Definition378 appliesTo: "App, CLI, IDE extension",
379 379 description: "Lifecycle point where configured hook handlers can run.",
380Desktop app for running Codex threads in parallel, with built-in worktree support, automations, and Git functionality.380 },
381 381 {
382Applies to382 key: "Hunk",
383 383 href: "/codex/app/review#staging-and-reverting-files",
384Desktop384 appliesTo: "App, Git, Review",
385 385 description:
386Term386 "Contiguous section of a diff that can be staged, unstaged, or reverted independently.",
387 387 },
388[Codex app-server](https://developers.openai.com/codex/app-server)388 {
389 389 key: "Inline comment",
390Definition390 href: "/codex/app/review#inline-comments-for-feedback",
391 391 appliesTo: "App",
392Local JSON-RPC server for embedding Codex threads, turns, approvals, history, and streamed events in custom clients.392 description: "Line-specific feedback attached to a diff.",
393 393 },
394Applies to394 {
395 395 key: "Live web search",
396App, IDE extension, SDK396 href: "/codex/config-basic#web-search-mode",
397 397 appliesTo: "App, CLI, IDE extension",
398Term398 description: "Real-time web lookup for current information.",
399 399 },
400[Codex CLI](https://developers.openai.com/codex/cli)400 {
401 401 key: "Local",
402Definition402 href: "/codex/app/worktrees#working-between-local-and-worktree",
403 403 appliesTo: "App, CLI, IDE extension",
404Terminal client for running Codex interactively or in scripts.404 description: "Mode where Codex works on the user's computer.",
405 405 },
406Applies to406 {
407 407 key: "Local thread",
408Terminal408 href: "/codex/prompting#threads",
409 409 appliesTo: "App, CLI, IDE extension",
410Term410 description: "A thread that runs on the user's machine.",
411 411 },
412[Codex cloud](https://developers.openai.com/codex/cloud)412 {
413 413 key: "Maintenance script",
414Definition414 href: "/codex/cloud/environments#container-caching",
415 415 appliesTo: "Cloud",
416OpenAI-managed execution environment where Codex can work on repository tasks remotely.416 description: "Optional script run when a cached cloud container resumes.",
417 417 },
418Applies to418 {
419 419 key: "Managed configuration",
420Web, App, IDE extension420 href: "/codex/enterprise/managed-configuration",
421 421 appliesTo: "Enterprise",
422Term422 description: "Organization-controlled Codex defaults and restrictions.",
423 423 },
424[codex exec](https://developers.openai.com/codex/noninteractive)424 {
425 425 key: "MCP",
426Definition426 href: "/codex/mcp",
427 427 appliesTo: "App, CLI, IDE extension",
428CLI command for running Codex non-interactively from scripts or CI.428 description:
429 429 "Model Context Protocol, a standard for connecting Codex to external tools and context.",
430Applies to430 },
431 431 {
432CLI432 key: "MCP resource",
433 433 href: "/codex/mcp#supported-mcp-features",
434Term434 appliesTo: "App, CLI, IDE extension",
435 435 description:
436[Codex IDE extension](https://developers.openai.com/codex/ide)436 "Readable context exposed by an MCP server for Codex to inspect.",
437 437 },
438Definition438 {
439 439 key: "MCP server",
440Editor integration for using Codex inside IDEs like VS Code, JetBrains IDEs, Cursor, and Windsurf.440 href: "/codex/mcp#supported-mcp-features",
441 441 appliesTo: "App, CLI, IDE extension",
442Applies to442 description: "External tool or context provider exposed through MCP.",
443 443 },
444IDE444 {
445 445 key: "MCP tool",
446Term446 href: "/codex/mcp#supported-mcp-features",
447 447 appliesTo: "App, CLI, IDE extension",
448[Codex SDK](https://developers.openai.com/codex/sdk)448 description:
449 449 "Action exposed by an MCP server that Codex can call during a task.",
450Definition450 },
451 451 {
452Programmatic interface for building Codex-powered workflows or integrations.452 key: "MDM",
453 453 href: "/codex/enterprise/managed-configuration#macos-managed-preferences-mdm",
454Applies to454 appliesTo: "Enterprise",
455 455 description:
456SDK456 "Mobile device management tooling for distributing device profiles and managed Codex settings.",
457 457 },
458Term458 {
459 459 key: "Memories",
460[Codex web](https://developers.openai.com/codex/cloud)460 href: "/codex/memories",
461 461 appliesTo: "App, CLI, IDE extension",
462Definition462 description: "Locally stored context Codex can reuse across sessions.",
463 463 },
464Browser-based Codex surface for delegating cloud tasks.464 {
465 465 key: "Model",
466Applies to466 href: "/codex/models",
467 467 appliesTo: "App, CLI, IDE extension, Cloud, SDK",
468Browser468 description: "The AI model Codex uses for reasoning and tool work.",
469 469 },
470Term470 {
471 471 key: "Network access",
472[Codex-managed worktree](https://developers.openai.com/codex/app/worktrees#codex-managed-and-permanent-worktrees)472 href: "/codex/agent-approvals-security#network-access-",
473 473 appliesTo: "App, CLI, IDE extension, Cloud",
474Definition474 description:
475 475 "Permission for commands or environments to reach the internet.",
476A temporary worktree Codex creates and manages for a thread.476 },
477 477 {
478Applies to478 key: "Network policy",
479 479 href: "/codex/agent-approvals-security#network-policy",
480App480 appliesTo: "App, CLI, IDE extension",
481 481 description:
482Term482 "Domain-based allow and deny rules that constrain sandboxed outbound network traffic.",
483 483 },
484[Compaction](https://developers.openai.com/codex/prompting#context)484 {
485 485 key: "Non-interactive mode",
486Definition486 href: "/codex/noninteractive",
487 487 appliesTo: "CLI",
488Summarizing older context so long-running work can continue.488 description: "CLI mode for running Codex from scripts or CI.",
489 489 },
490Applies to490 {
491 491 key: "Output schema",
492App, CLI, IDE extension, Cloud492 href: "/codex/noninteractive#create-structured-outputs-with-a-schema",
493 493 appliesTo: "CLI",
494Term494 description:
495 495 "JSON Schema passed to `codex exec` to constrain the final response.",
496[Compliance API](https://developers.openai.com/codex/enterprise/governance#compliance-api)496 },
497 497 {
498Definition498 key: "Permanent worktree",
499 499 href: "/codex/app/worktrees#codex-managed-and-permanent-worktrees",
500API for exporting Codex activity and audit metadata.500 appliesTo: "App",
501 501 description: "A long-lived worktree kept as its own project.",
502Applies to502 },
503 503 {
504Enterprise504 key: "Permission profile",
505 505 href: "/codex/permissions#define-and-select-a-profile",
506Term506 appliesTo: "App, CLI, IDE extension",
507 507 description:
508[Computer use](https://developers.openai.com/codex/app/computer-use)508 "Named least-privilege policy that combines filesystem and network rules for local command execution.",
509 509 },
510Definition510 {
511 511 key: "Plan",
512App capability that lets Codex interact with desktop applications through the UI.512 href: "/codex/learn/best-practices#plan-first-for-difficult-tasks",
513 513 appliesTo: "App, CLI, IDE extension, Cloud",
514Applies to514 description: "Codex's proposed or tracked steps for completing a task.",
515 515 },
516App516 {
517 517 key: "Plugin",
518Term518 href: "/codex/plugins",
519 519 appliesTo: "App, CLI, IDE extension",
520[config.toml](https://developers.openai.com/codex/config-reference#configtoml)520 description:
521 521 "Installable bundle that can distribute skills, tools, and integrations.",
522Definition522 },
523 523 {
524Local Codex configuration files.524 key: "Plugin manifest",
525 525 href: "/codex/plugins/build#plugin-structure",
526Applies to526 appliesTo: "App, CLI, IDE extension, Plugins",
527 527 description:
528App, CLI, IDE extension528 "Plugin metadata file that identifies a plugin and points to bundled skills, apps, MCP servers, hooks, and metadata.",
529 529 },
530Term530 {
531 531 key: "Prefix rule",
532[Connected host](https://developers.openai.com/codex/remote-connections#what-comes-from-the-connected-host)532 href: "/codex/rules#understand-the-rules-language",
533 533 appliesTo: "App, CLI, IDE extension, Enterprise",
534Definition534 description:
535 535 "Command-rule pattern that allows, prompts for, or forbids matching command prefixes.",
536Computer or development environment that provides files, tools, and shell access for remote Codex work.536 },
537 537 {
538Applies to538 key: "Profile",
539 539 href: "/codex/config-advanced#profiles",
540App, Mobile540 appliesTo: "CLI, IDE extension",
541 541 description: "Named configuration preset for Codex.",
542Term542 },
543 543 {
544[Connector](https://developers.openai.com/codex/plugins)544 key: "Progressive disclosure",
545 545 href: "/codex/skills",
546Definition546 appliesTo: "App, CLI, IDE extension",
547 547 description:
548App integration that lets Codex access external services. Available through plugins; also called apps.548 "Loading skill details only when needed to preserve context.",
549 549 },
550Applies to550 {
551 551 key: "Project",
552App, Cloud552 href: "/codex/app/features#multitask-across-projects",
553 553 appliesTo: "App",
554Term554 description: "A selected codebase or folder Codex works in.",
555 555 },
556[Container cache](https://developers.openai.com/codex/cloud/environments#container-caching)556 {
557 557 key: "Prompt",
558Definition558 href: "/codex/prompting",
559 559 appliesTo: "App, CLI, IDE extension, Cloud, SDK",
560Saved cloud container state reused to speed up future tasks.560 description: "The user instruction or request sent to Codex.",
561 561 },
562Applies to562 {
563 563 key: "Pull request review",
564Cloud564 href: "/codex/app/review#pull-request-reviews",
565 565 appliesTo: "App, CLI, GitHub",
566Term566 description: "Codex review of changes or feedback on a pull request.",
567 567 },
568[Context](https://developers.openai.com/codex/prompting#context)568 {
569 569 key: "RBAC",
570Definition570 href: "/codex/enterprise/admin-setup#step-2-set-up-custom-roles-rbac",
571 571 appliesTo: "Enterprise",
572Information Codex can use while working, such as files, prior messages, tool output, and instructions.572 description: "Role-based access control for workspace permissions.",
573 573 },
574Applies to574 {
575 575 key: "Read-only mode",
576App, CLI, IDE extension, Cloud, SDK576 href: "/codex/concepts/sandboxing",
577 577 appliesTo: "App, CLI, IDE extension",
578Term578 description:
579 579 "Mode where Codex can inspect but not modify without approval.",
580[Context window](https://developers.openai.com/api/docs/guides/conversation-state#managing-the-context-window)580 },
581 581 {
582Definition582 key: "Reasoning effort",
583 583 href: "/codex/config-basic#reasoning-effort",
584The maximum amount of information the model can consider at once.584 appliesTo: "App, CLI, IDE extension, SDK",
585 585 description:
586Applies to586 "Setting that controls how much reasoning budget a model uses.",
587 587 },
588App, CLI, IDE extension, Cloud, SDK588 {
589 589 key: "Remote connection",
590Term590 href: "/codex/remote-connections",
591 591 appliesTo: "App, Mobile",
592[Custom agent](https://developers.openai.com/codex/subagents#custom-agents)592 description:
593 593 "Connection that lets Codex work from another device using a connected host.",
594Definition594 },
595 595 {
596User-defined agent role with its own instructions and settings.596 key: "requirements.toml",
597 597 href: "/codex/config-reference#requirementstoml",
598Applies to598 appliesTo: "Enterprise",
599 599 description: "Admin-enforced requirements file for managed Codex setups.",
600App, CLI600 },
601 601 {
602Term602 key: "Review pane",
603 603 href: "/codex/app/review",
604[Deny-read rule](https://developers.openai.com/codex/permissions#deny-reads-with-exact-paths-or-globs)604 appliesTo: "App",
605 605 description: "App view for inspecting diffs, comments, and Git changes.",
606Definition606 },
607 607 {
608Filesystem permission rule that prevents Codex from reading sensitive paths or glob matches.608 key: "Rules",
609 609 href: "/codex/rules",
610Applies to610 appliesTo: "App, CLI, IDE extension",
611 611 description:
612App, CLI, IDE extension, Enterprise612 "Policies that allow, prompt for, or deny command prefixes or permission exceptions.",
613 613 },
614Term614 {
615 615 key: "Sandbox",
616[Diff](https://developers.openai.com/codex/app/review#what-changes-it-shows)616 href: "/codex/concepts/sandboxing",
617 617 appliesTo: "App, CLI, IDE extension",
618Definition618 description:
619 619 "Enforced boundary limiting what Codex commands can access or modify.",
620Set of Git file changes shown for inspection, comments, staging, or reverting.620 },
621 621 {
622Applies to622 key: "Sandbox mode",
623 623 href: "/codex/config-basic#sandbox-level",
624App, Git, Review624 appliesTo: "App, CLI, IDE extension",
625 625 description:
626Term626 "Configuration that defines Codex's filesystem and network limits.",
627 627 },
628[Domain allowlist](https://developers.openai.com/codex/cloud/internet-access#domain-allowlist)628 {
629 629 key: "Sandbox preset",
630Definition630 href: "/codex/sdk#sandbox-presets",
631 631 appliesTo: "SDK",
632Set of domains Codex cloud can reach when agent internet access is enabled.632 description:
633 633 "SDK shorthand for common sandbox policies such as read-only, workspace-write, or full access.",
634Applies to634 },
635 635 {
636Cloud636 key: "Schedule",
637 637 href: "/codex/app/automations",
638Term638 appliesTo: "App",
639 639 description: "The timing rule for an automation.",
640[Environment (local)](https://developers.openai.com/codex/app/local-environments)640 },
641 641 {
642Definition642 key: "Secret",
643 643 href: "/codex/cloud/environments#environment-variables-and-secrets",
644App configuration to tell Codex how to set up worktrees for a project.644 appliesTo: "Cloud",
645 645 description:
646Applies to646 "Encrypted value available to setup scripts but removed before the agent phase.",
647 647 },
648App, Worktree648 {
649 649 key: "Setup script",
650Term650 href: "/codex/app/local-environments#setup-scripts",
651 651 appliesTo: "App worktrees",
652[Environment variable](https://developers.openai.com/codex/cloud/environments#environment-variables-and-secrets)652 description:
653 653 "Script run before the agent starts to install dependencies or prepare tools.",
654Definition654 },
655 655 {
656Runtime configuration value available during task execution.656 key: "Skill",
657 657 href: "/codex/skills",
658Applies to658 appliesTo: "App, CLI, IDE extension",
659 659 description:
660Cloud, CLI, IDE extension660 "Reusable workflow package with instructions and optional scripts or references.",
661 661 },
662Term662 {
663 663 key: "Skill invocation",
664[Ephemeral session](https://developers.openai.com/codex/noninteractive#basic-usage)664 href: "/codex/skills#how-codex-uses-skills",
665 665 appliesTo: "App, CLI, IDE extension",
666Definition666 description: "Explicit or implicit activation of a skill.",
667 667 },
668Non-interactive run that skips saving session state after it completes.668 {
669 669 key: "Slash command",
670Applies to670 href: "/codex/cli/slash-commands",
671 671 appliesTo: "CLI",
672CLI672 description:
673 673 "Command entered with a leading slash to control or inspect a Codex CLI session.",
674Term674 },
675 675 {
676[Fast mode](https://developers.openai.com/codex/speed#fast-mode)676 key: "Standalone automation",
677 677 href: "/codex/app/automations",
678Definition678 appliesTo: "App",
679 679 description: "Independent scheduled run that reports separate findings.",
680Speed setting that makes supported models respond faster at a higher credit cost.680 },
681 681 {
682Applies to682 key: "STDIO MCP server",
683 683 href: "/codex/mcp#stdio-servers",
684CLI, IDE extension684 appliesTo: "CLI, IDE extension",
685 685 description:
686Term686 "MCP server launched as a local process by a configured command and arguments.",
687 687 },
688[Filesystem permission](https://developers.openai.com/codex/permissions#filesystem-permissions)688 {
689 689 key: "Streamable HTTP MCP server",
690Definition690 href: "/codex/mcp#streamable-http-servers",
691 691 appliesTo: "CLI, IDE extension",
692Permission profile rule that grants or denies read and write access to paths.692 description:
693 693 "MCP server reached over HTTP, optionally with bearer token or OAuth authentication.",
694Applies to694 },
695 695 {
696App, CLI, IDE extension696 key: "Subagent",
697 697 href: "/codex/concepts/subagents",
698Term698 appliesTo: "App, CLI",
699 699 description: "Specialized child agent spawned to work on part of a task.",
700[Finding](https://developers.openai.com/codex/app/automations#managing-tasks)700 },
701 701 {
702Definition702 key: "Subagent workflow",
703 703 href: "/codex/concepts/subagents#core-terms",
704A notable result or issue surfaced by an automation.704 appliesTo: "App, CLI",
705 705 description:
706Applies to706 "Workflow where Codex runs delegated agents in parallel and combines their results.",
707 707 },
708App708 {
709 709 key: "Task",
710Term710 href: "/codex/app/automations#managing-tasks",
711 711 appliesTo: "App, CLI, IDE extension, Cloud, SDK",
712[Full access](https://developers.openai.com/codex/concepts/sandboxing#configure-defaults)712 description: "The unit of work Codex is asked to complete.",
713 713 },
714Definition714 {
715 715 key: "Thread",
716Mode where Codex runs without normal sandbox restrictions.716 href: "/codex/prompting#threads",
717 717 appliesTo: "App, CLI, IDE extension, Cloud, SDK",
718Applies to718 description:
719 719 "A single Codex session containing prompts, model output, and tool activity.",
720App, CLI, IDE extension720 },
721 721 {
722Term722 key: "Thread automation",
723 723 href: "/codex/app/automations#thread-automations",
724[Git worktree](https://developers.openai.com/codex/app/worktrees#whats-a-worktree)724 appliesTo: "App",
725 725 description:
726Definition726 "Recurring wake-up attached to an existing thread. Also called a heartbeat.",
727 727 },
728A second checkout of the same repository for parallel branch work.728 {
729 729 key: "Thread fork",
730Applies to730 href: "/codex/app-server#start-or-resume-a-thread",
731 731 appliesTo: "App-server, SDK",
732App, Git732 description:
733 733 "New thread branched from the stored history of an existing thread.",
734Term734 },
735 735 {
736[Handoff](https://developers.openai.com/codex/app/worktrees#working-between-local-and-worktree)736 key: "Turn",
737 737 href: "/codex/app-server#core-primitives",
738Definition738 appliesTo: "App, CLI, IDE extension, Cloud, SDK",
739 739 description:
740Moving a thread and its work between Local and Worktree.740 "One exchange in a thread, usually a user prompt plus Codex's response and actions.",
741 741 },
742Applies to742 {
743 743 key: "Universal image",
744App744 href: "/codex/cloud/environments#default-universal-image",
745 745 appliesTo: "Cloud",
746Term746 description:
747 747 "Default Codex cloud container image with common tools preinstalled.",
748[Heartbeat](https://developers.openai.com/codex/app/automations#thread-automations)748 },
749 749 {
750Definition750 key: "Web search cache",
751 751 href: "/codex/config-basic#web-search-mode",
752A recurring thread wake-up that returns Codex to the same conversation on a schedule. Also called a thread automation.752 appliesTo: "App, CLI, IDE extension",
753 753 description:
754Applies to754 "Pre-indexed search results Codex can use without live browsing.",
755 755 },
756App756 {
757 757 key: "Worktree",
758Term758 href: "/codex/app/worktrees",
759 759 appliesTo: "App",
760[Hook](https://developers.openai.com/codex/hooks)760 description:
761 761 "Mode where Codex isolates changes in a separate Git worktree.",
762Definition762 },
763 763 {
764A lifecycle handler that runs when a Codex event matches, such as tool use, permission requests, or when a turn stops.764 key: "Writable roots",
765 765 href: "/codex/agent-approvals-security#protected-paths-in-writable-roots",
766Applies to766 appliesTo: "App, CLI, IDE extension",
767 767 description: "Directories Codex is allowed to modify.",
768App, CLI, IDE extension768 },
769 769 ]}
770Term770/>
771
772[Hook event](https://developers.openai.com/codex/hooks#config-shape)
773
774Definition
775
776Lifecycle point where configured hook handlers can run.
777
778Applies to
779
780App, CLI, IDE extension
781
782Term
783
784[Hunk](https://developers.openai.com/codex/app/review#staging-and-reverting-files)
785
786Definition
787
788Contiguous section of a diff that can be staged, unstaged, or reverted independently.
789
790Applies to
791
792App, Git, Review
793
794Term
795
796[Inline comment](https://developers.openai.com/codex/app/review#inline-comments-for-feedback)
797
798Definition
799
800Line-specific feedback attached to a diff.
801
802Applies to
803
804App
805
806Term
807
808[Live web search](https://developers.openai.com/codex/config-basic#web-search-mode)
809
810Definition
811
812Real-time web lookup for current information.
813
814Applies to
815
816App, CLI, IDE extension
817
818Term
819
820[Local](https://developers.openai.com/codex/app/worktrees#working-between-local-and-worktree)
821
822Definition
823
824Mode where Codex works on the user's computer.
825
826Applies to
827
828App, CLI, IDE extension
829
830Term
831
832[Local thread](https://developers.openai.com/codex/prompting#threads)
833
834Definition
835
836A thread that runs on the user's machine.
837
838Applies to
839
840App, CLI, IDE extension
841
842Term
843
844[Maintenance script](https://developers.openai.com/codex/cloud/environments#container-caching)
845
846Definition
847
848Optional script run when a cached cloud container resumes.
849
850Applies to
851
852Cloud
853
854Term
855
856[Managed configuration](https://developers.openai.com/codex/enterprise/managed-configuration)
857
858Definition
859
860Organization-controlled Codex defaults and restrictions.
861
862Applies to
863
864Enterprise
865
866Term
867
868[MCP](https://developers.openai.com/codex/mcp)
869
870Definition
871
872Model Context Protocol, a standard for connecting Codex to external tools and context.
873
874Applies to
875
876App, CLI, IDE extension
877
878Term
879
880[MCP resource](https://developers.openai.com/codex/mcp#supported-mcp-features)
881
882Definition
883
884Readable context exposed by an MCP server for Codex to inspect.
885
886Applies to
887
888App, CLI, IDE extension
889
890Term
891
892[MCP server](https://developers.openai.com/codex/mcp#supported-mcp-features)
893
894Definition
895
896External tool or context provider exposed through MCP.
897
898Applies to
899
900App, CLI, IDE extension
901
902Term
903
904[MCP tool](https://developers.openai.com/codex/mcp#supported-mcp-features)
905
906Definition
907
908Action exposed by an MCP server that Codex can call during a task.
909
910Applies to
911
912App, CLI, IDE extension
913
914Term
915
916[MDM](https://developers.openai.com/codex/enterprise/managed-configuration#macos-managed-preferences-mdm)
917
918Definition
919
920Mobile device management tooling for distributing device profiles and managed Codex settings.
921
922Applies to
923
924Enterprise
925
926Term
927
928[Memories](https://developers.openai.com/codex/memories)
929
930Definition
931
932Locally stored context Codex can reuse across sessions.
933
934Applies to
935
936App, CLI, IDE extension
937
938Term
939
940[Model](https://developers.openai.com/codex/models)
941
942Definition
943
944The AI model Codex uses for reasoning and tool work.
945
946Applies to
947
948App, CLI, IDE extension, Cloud, SDK
949
950Term
951
952[Network access](https://developers.openai.com/codex/agent-approvals-security#network-access-)
953
954Definition
955
956Permission for commands or environments to reach the internet.
957
958Applies to
959
960App, CLI, IDE extension, Cloud
961
962Term
963
964[Network policy](https://developers.openai.com/codex/agent-approvals-security#network-policy)
965
966Definition
967
968Domain-based allow and deny rules that constrain sandboxed outbound network traffic.
969
970Applies to
971
972App, CLI, IDE extension
973
974Term
975
976[Non-interactive mode](https://developers.openai.com/codex/noninteractive)
977
978Definition
979
980CLI mode for running Codex from scripts or CI.
981
982Applies to
983
984CLI
985
986Term
987
988[Output schema](https://developers.openai.com/codex/noninteractive#create-structured-outputs-with-a-schema)
989
990Definition
991
992JSON Schema passed to `codex exec` to constrain the final response.
993
994Applies to
995
996CLI
997
998Term
999
1000[Permanent worktree](https://developers.openai.com/codex/app/worktrees#codex-managed-and-permanent-worktrees)
1001
1002Definition
1003
1004A long-lived worktree kept as its own project.
1005
1006Applies to
1007
1008App
1009
1010Term
1011
1012[Permission profile](https://developers.openai.com/codex/permissions#define-and-select-a-profile)
1013
1014Definition
1015
1016Named least-privilege policy that combines filesystem and network rules for local command execution.
1017
1018Applies to
1019
1020App, CLI, IDE extension
1021
1022Term
1023
1024[Plan](https://developers.openai.com/codex/learn/best-practices#plan-first-for-difficult-tasks)
1025
1026Definition
1027
1028Codex's proposed or tracked steps for completing a task.
1029
1030Applies to
1031
1032App, CLI, IDE extension, Cloud
1033
1034Term
1035
1036[Plugin](https://developers.openai.com/codex/plugins)
1037
1038Definition
1039
1040Installable bundle that can distribute skills, tools, and integrations.
1041
1042Applies to
1043
1044App, CLI, IDE extension
1045
1046Term
1047
1048[Plugin manifest](https://developers.openai.com/codex/plugins/build#plugin-structure)
1049
1050Definition
1051
1052Plugin metadata file that identifies a plugin and points to bundled skills, apps, MCP servers, hooks, and metadata.
1053
1054Applies to
1055
1056App, CLI, IDE extension, Plugins
1057
1058Term
1059
1060[Prefix rule](https://developers.openai.com/codex/rules#understand-the-rules-language)
1061
1062Definition
1063
1064Command-rule pattern that allows, prompts for, or forbids matching command prefixes.
1065
1066Applies to
1067
1068App, CLI, IDE extension, Enterprise
1069
1070Term
1071
1072[Profile](https://developers.openai.com/codex/config-advanced#profiles)
1073
1074Definition
1075
1076Named configuration preset for Codex.
1077
1078Applies to
1079
1080CLI, IDE extension
1081
1082Term
1083
1084[Progressive disclosure](https://developers.openai.com/codex/skills)
1085
1086Definition
1087
1088Loading skill details only when needed to preserve context.
1089
1090Applies to
1091
1092App, CLI, IDE extension
1093
1094Term
1095
1096[Project](https://developers.openai.com/codex/app/features#multitask-across-projects)
1097
1098Definition
1099
1100A selected codebase or folder Codex works in.
1101
1102Applies to
1103
1104App
1105
1106Term
1107
1108[Prompt](https://developers.openai.com/codex/prompting)
1109
1110Definition
1111
1112The user instruction or request sent to Codex.
1113
1114Applies to
1115
1116App, CLI, IDE extension, Cloud, SDK
1117
1118Term
1119
1120[Pull request review](https://developers.openai.com/codex/app/review#pull-request-reviews)
1121
1122Definition
1123
1124Codex review of changes or feedback on a pull request.
1125
1126Applies to
1127
1128App, CLI, GitHub
1129
1130Term
1131
1132[RBAC](https://developers.openai.com/codex/enterprise/admin-setup#step-2-set-up-custom-roles-rbac)
1133
1134Definition
1135
1136Role-based access control for workspace permissions.
1137
1138Applies to
1139
1140Enterprise
1141
1142Term
1143
1144[Read-only mode](https://developers.openai.com/codex/concepts/sandboxing)
1145
1146Definition
1147
1148Mode where Codex can inspect but not modify without approval.
1149
1150Applies to
1151
1152App, CLI, IDE extension
1153
1154Term
1155
1156[Reasoning effort](https://developers.openai.com/codex/config-basic#reasoning-effort)
1157
1158Definition
1159
1160Setting that controls how much reasoning budget a model uses.
1161
1162Applies to
1163
1164App, CLI, IDE extension, SDK
1165
1166Term
1167
1168[Remote connection](https://developers.openai.com/codex/remote-connections)
1169
1170Definition
1171
1172Connection that lets Codex work from another device using a connected host.
1173
1174Applies to
1175
1176App, Mobile
1177
1178Term
1179
1180[requirements.toml](https://developers.openai.com/codex/config-reference#requirementstoml)
1181
1182Definition
1183
1184Admin-enforced requirements file for managed Codex setups.
1185
1186Applies to
1187
1188Enterprise
1189
1190Term
1191
1192[Review pane](https://developers.openai.com/codex/app/review)
1193
1194Definition
1195
1196App view for inspecting diffs, comments, and Git changes.
1197
1198Applies to
1199
1200App
1201
1202Term
1203
1204[Rules](https://developers.openai.com/codex/rules)
1205
1206Definition
1207
1208Policies that allow, prompt for, or deny command prefixes or permission exceptions.
1209
1210Applies to
1211
1212App, CLI, IDE extension
1213
1214Term
1215
1216[Sandbox](https://developers.openai.com/codex/concepts/sandboxing)
1217
1218Definition
1219
1220Enforced boundary limiting what Codex commands can access or modify.
1221
1222Applies to
1223
1224App, CLI, IDE extension
1225
1226Term
1227
1228[Sandbox mode](https://developers.openai.com/codex/config-basic#sandbox-level)
1229
1230Definition
1231
1232Configuration that defines Codex's filesystem and network limits.
1233
1234Applies to
1235
1236App, CLI, IDE extension
1237
1238Term
1239
1240[Sandbox preset](https://developers.openai.com/codex/sdk#sandbox-presets)
1241
1242Definition
1243
1244SDK shorthand for common sandbox policies such as read-only, workspace-write, or full access.
1245
1246Applies to
1247
1248SDK
1249
1250Term
1251
1252[Schedule](https://developers.openai.com/codex/app/automations)
1253
1254Definition
1255
1256The timing rule for an automation.
1257
1258Applies to
1259
1260App
1261
1262Term
1263
1264[Secret](https://developers.openai.com/codex/cloud/environments#environment-variables-and-secrets)
1265
1266Definition
1267
1268Encrypted value available to setup scripts but removed before the agent phase.
1269
1270Applies to
1271
1272Cloud
1273
1274Term
1275
1276[Setup script](https://developers.openai.com/codex/app/local-environments#setup-scripts)
1277
1278Definition
1279
1280Script run before the agent starts to install dependencies or prepare tools.
1281
1282Applies to
1283
1284App worktrees
1285
1286Term
1287
1288[Skill](https://developers.openai.com/codex/skills)
1289
1290Definition
1291
1292Reusable workflow package with instructions and optional scripts or references.
1293
1294Applies to
1295
1296App, CLI, IDE extension
1297
1298Term
1299
1300[Skill invocation](https://developers.openai.com/codex/skills#how-codex-uses-skills)
1301
1302Definition
1303
1304Explicit or implicit activation of a skill.
1305
1306Applies to
1307
1308App, CLI, IDE extension
1309
1310Term
1311
1312[Slash command](https://developers.openai.com/codex/cli/slash-commands)
1313
1314Definition
1315
1316Command entered with a leading slash to control or inspect a Codex CLI session.
1317
1318Applies to
1319
1320CLI
1321
1322Term
1323
1324[Standalone automation](https://developers.openai.com/codex/app/automations)
1325
1326Definition
1327
1328Independent scheduled run that reports separate findings.
1329
1330Applies to
1331
1332App
1333
1334Term
1335
1336[STDIO MCP server](https://developers.openai.com/codex/mcp#stdio-servers)
1337
1338Definition
1339
1340MCP server launched as a local process by a configured command and arguments.
1341
1342Applies to
1343
1344CLI, IDE extension
1345
1346Term
1347
1348[Streamable HTTP MCP server](https://developers.openai.com/codex/mcp#streamable-http-servers)
1349
1350Definition
1351
1352MCP server reached over HTTP, optionally with bearer token or OAuth authentication.
1353
1354Applies to
1355
1356CLI, IDE extension
1357
1358Term
1359
1360[Subagent](https://developers.openai.com/codex/concepts/subagents)
1361
1362Definition
1363
1364Specialized child agent spawned to work on part of a task.
1365
1366Applies to
1367
1368App, CLI
1369
1370Term
1371
1372[Subagent workflow](https://developers.openai.com/codex/concepts/subagents#core-terms)
1373
1374Definition
1375
1376Workflow where Codex runs delegated agents in parallel and combines their results.
1377
1378Applies to
1379
1380App, CLI
1381
1382Term
1383
1384[Task](https://developers.openai.com/codex/app/automations#managing-tasks)
1385
1386Definition
1387
1388The unit of work Codex is asked to complete.
1389
1390Applies to
1391
1392App, CLI, IDE extension, Cloud, SDK
1393
1394Term
1395
1396[Thread](https://developers.openai.com/codex/prompting#threads)
1397
1398Definition
1399
1400A single Codex session containing prompts, model output, and tool activity.
1401
1402Applies to
1403
1404App, CLI, IDE extension, Cloud, SDK
1405
1406Term
1407
1408[Thread automation](https://developers.openai.com/codex/app/automations#thread-automations)
1409
1410Definition
1411
1412Recurring wake-up attached to an existing thread. Also called a heartbeat.
1413
1414Applies to
1415
1416App
1417
1418Term
1419
1420[Thread fork](https://developers.openai.com/codex/app-server#start-or-resume-a-thread)
1421
1422Definition
1423
1424New thread branched from the stored history of an existing thread.
1425
1426Applies to
1427
1428App-server, SDK
1429
1430Term
1431
1432[Turn](https://developers.openai.com/codex/app-server#core-primitives)
1433
1434Definition
1435
1436One exchange in a thread, usually a user prompt plus Codex's response and actions.
1437
1438Applies to
1439
1440App, CLI, IDE extension, Cloud, SDK
1441
1442Term
1443
1444[Universal image](https://developers.openai.com/codex/cloud/environments#default-universal-image)
1445
1446Definition
1447
1448Default Codex cloud container image with common tools preinstalled.
1449
1450Applies to
1451
1452Cloud
1453
1454Term
1455
1456[Web search cache](https://developers.openai.com/codex/config-basic#web-search-mode)
1457
1458Definition
1459
1460Pre-indexed search results Codex can use without live browsing.
1461
1462Applies to
1463
1464App, CLI, IDE extension
1465
1466Term
1467
1468[Worktree](https://developers.openai.com/codex/app/worktrees)
1469
1470Definition
1471
1472Mode where Codex isolates changes in a separate Git worktree.
1473
1474Applies to
1475
1476App
1477
1478Term
1479
1480[Writable roots](https://developers.openai.com/codex/agent-approvals-security#protected-paths-in-writable-roots)
1481
1482Definition
1483
1484Directories Codex is allowed to modify.
1485
1486Applies to
1487
1488App, CLI, IDE extension
1489
1490Expand to view all
1491