Primary navigation

Glossary

Definitions for common Codex terms and concepts

Use this glossary as a quick reference for Codex terms across the app, CLI, IDE extension, cloud, SDK, and related integrations.

Term
Agent
Definition
The Codex agent that reasons over context, uses tools, and completes a task.
Applies to
Desktop app, CLI, IDE extension, Cloud
Definition
Repository or user guidance file that gives Codex persistent instructions.
Applies to
Desktop app, CLI, IDE extension, Cloud
Definition
Admin hub for ChatGPT workspace adoption and Codex-focused reporting.
Applies to
Enterprise
Definition
Authentication using an OpenAI API key.
Applies to
Desktop app, CLI, IDE extension
Definition
Rules for when Codex must ask before taking an action.
Applies to
Desktop app, CLI, IDE extension
Definition
Codex asking to allow a restricted action.
Applies to
Desktop app, CLI, IDE extension
Definition
Compatibility name used by Codex configuration and app-server fields for connectors.
Applies to
Desktop app, CLI, IDE extension
Definition
Snapshot of the frontmost app window sent to a Work or Codex task.
Applies to
Desktop app
Definition
Locally stored login credentials reused by Codex.
Applies to
Desktop app, CLI, IDE extension
Definition
Model-based review of eligible approval requests before they proceed.
Applies to
Desktop app, CLI, IDE extension
Term
Chat
Definition
An ordinary ChatGPT conversation containing prompts and responses. Quick Chat opens this same conversation type.
Applies to
Desktop app, Web, Mobile
Definition
Desktop app with ChatGPT Work, Codex, and a separate Quick Chat window, including projects, file previews, scheduled tasks, and developer tools.
Applies to
Desktop
Definition
Authentication using a ChatGPT account and workspace permissions.
Applies to
Desktop app, CLI, IDE extension, Cloud
Definition
Opt-in feature that builds memories from recent screen context.
Applies to
Desktop app
Term
Cloud
Definition
Mode where Codex works remotely in an OpenAI-managed environment.
Applies to
Desktop app, IDE extension, Web
Definition
Configured container setup used for Codex cloud tasks.
Applies to
Cloud
Definition
A remotely executed Codex task that runs in a cloud environment.
Applies to
Cloud
Term
Codex
Definition
OpenAI's coding agent for software development tasks.
Applies to
Desktop app, CLI, IDE extension, Web, Cloud, SDK
Definition
Local JSON-RPC server for embedding Codex threads, turns, approvals, history, and streamed events in custom clients.
Applies to
Desktop app, IDE extension, SDK
Definition
Terminal client for running Codex interactively or in scripts.
Applies to
Terminal
Definition
OpenAI-managed execution environment where Codex can work on repository tasks remotely.
Applies to
Web, Desktop app, IDE extension
Definition
CLI command for running Codex non-interactively from scripts or CI.
Applies to
CLI
Definition
Editor integration for using Codex inside IDEs like VS Code, JetBrains IDEs, Cursor, and Windsurf.
Applies to
IDE
Definition
Programmatic interface for building Codex-powered workflows or integrations.
Applies to
SDK
Definition
A temporary worktree Codex creates and manages for a task.
Applies to
Desktop app
Definition
Summarizing older context so long-running work can continue.
Applies to
Desktop app, CLI, IDE extension, Cloud
Definition
API for exporting supported ChatGPT workspace records and audit metadata.
Applies to
Enterprise
Definition
Desktop capability that lets ChatGPT interact with other applications through the UI.
Applies to
Desktop app
Definition
Capability that lets ChatGPT operate the built-in browser directly.
Applies to
Desktop app
Definition
Local Codex configuration files.
Applies to
Desktop app, CLI, IDE extension
Definition
Computer or development environment that provides files, tools, and shell access for Work or Codex tasks opened through Remote.
Applies to
Desktop app, Mobile
Definition
Connector that lets Work or Codex access external services through a plugin.
Applies to
Desktop app (Work, Codex), Web (Work)
Definition
Saved cloud container state reused to speed up future tasks.
Applies to
Cloud
Definition
Information Codex can use while working, such as files, prior messages, tool output, and instructions.
Applies to
Desktop app, CLI, IDE extension, Cloud, SDK
Definition
The maximum amount of information the model can consider at once.
Applies to
Desktop app, CLI, IDE extension, Cloud, SDK
Definition
User-defined agent role with its own instructions and settings.
Applies to
Desktop app, CLI
Definition
Filesystem permission rule that prevents Codex from reading sensitive paths or glob matches.
Applies to
Desktop app, CLI, IDE extension, Enterprise
Term
Diff
Definition
Set of Git file changes shown for inspection, comments, staging, or reverting.
Applies to
Desktop app, Git, Review
Definition
Set of domains Codex cloud can reach when agent internet access is enabled.
Applies to
Cloud
Definition
Desktop app configuration that tells Codex how to set up worktrees for a project.
Applies to
Desktop app, Worktree
Definition
Runtime configuration value available during task execution.
Applies to
Cloud, CLI, IDE extension
Definition
Non-interactive run that skips saving session state after it completes.
Applies to
CLI
Definition
Speed setting that makes supported models respond faster at a higher credit cost.
Applies to
CLI, IDE extension
Definition
Permission profile rule that grants or denies read and write access to paths.
Applies to
Desktop app, CLI, IDE extension
Definition
A notable result or issue surfaced by a scheduled task.
Applies to
Desktop app
Definition
Mode where Codex runs without normal sandbox restrictions.
Applies to
Desktop app, CLI, IDE extension
Definition
A second checkout of the same repository for parallel branch work.
Applies to
Desktop app, Git
Definition
Moving a task and its work between Local and Worktree.
Applies to
Desktop app
Definition
Shorthand for recurring scheduled work that returns ChatGPT to the same task.
Applies to
Desktop app
Term
Hook
Definition
A lifecycle handler that runs when a Codex event matches, such as tool use, permission requests, or when a turn stops.
Applies to
Desktop app, CLI, IDE extension
Definition
Lifecycle point where configured hook handlers can run.
Applies to
Desktop app, CLI, IDE extension
Term
Hunk
Definition
Contiguous section of a diff that can be staged, unstaged, or reverted independently.
Applies to
Desktop app, Git, Review
Definition
Line-specific feedback attached to a diff.
Applies to
Desktop app
Definition
Real-time web lookup for current information.
Applies to
Desktop app, CLI, IDE extension
Term
Local
Definition
Mode where Codex works on the user's computer.
Applies to
Desktop app, CLI, IDE extension
Definition
A Work or Codex task that runs on the user's machine.
Applies to
Desktop app, CLI, IDE extension
Definition
Optional script run when a cached cloud container resumes.
Applies to
Cloud
Definition
Organization-controlled Codex defaults and restrictions.
Applies to
Enterprise
Term
MCP
Definition
Model Context Protocol, a standard for connecting Codex to external tools and context.
Applies to
Desktop app, CLI, IDE extension
Definition
Readable context exposed by an MCP server for Codex to inspect.
Applies to
Desktop app, CLI, IDE extension
Definition
External tool or context provider exposed through MCP.
Applies to
Desktop app, CLI, IDE extension
Definition
Action exposed by an MCP server that Codex can call during a task.
Applies to
Desktop app, CLI, IDE extension
Term
MDM
Definition
Mobile device management tooling for distributing device profiles and managed Codex settings.
Applies to
Enterprise
Definition
Locally stored context Codex can reuse across sessions.
Applies to
Desktop app, CLI, IDE extension
Term
Model
Definition
The AI model Codex uses for reasoning and tool work.
Applies to
Desktop app, CLI, IDE extension, Cloud, SDK
Definition
Permission for commands or environments to reach the internet.
Applies to
Desktop app, CLI, IDE extension, Cloud
Definition
Domain-based allow and deny rules that constrain sandboxed outbound network traffic.
Applies to
Desktop app, CLI, IDE extension
Definition
CLI mode for running Codex from scripts or CI.
Applies to
CLI
Definition
JSON Schema passed to `codex exec` to constrain the final response.
Applies to
CLI
Definition
A long-lived worktree kept as its own project.
Applies to
Desktop app
Definition
Named least-privilege policy that combines filesystem and network rules for local command execution.
Applies to
Desktop app, CLI, IDE extension
Term
Plan
Definition
Codex's proposed or tracked steps for completing a task.
Applies to
Desktop app, CLI, IDE extension, Cloud
Term
Plugin
Definition
Installable bundle that can distribute skills, tools, and integrations.
Applies to
Desktop app (Work, Codex), Web (Work), CLI
Definition
Plugin metadata file that identifies a plugin and points to bundled skills, apps, MCP servers, hooks, and metadata.
Applies to
Desktop app, CLI, IDE extension, Plugins
Definition
Command-rule pattern that allows, prompts for, or forbids matching command prefixes.
Applies to
Desktop app, CLI, IDE extension, Enterprise
Definition
Named configuration preset for Codex.
Applies to
CLI, IDE extension
Definition
Loading skill details only when needed to preserve context.
Applies to
Desktop app, CLI, IDE extension
Definition
A group of related chats or tasks and shared sources, or a local folder used for file-based work.
Applies to
Desktop app
Term
Prompt
Definition
A question, instruction, or goal sent to ChatGPT or Codex.
Applies to
Desktop app, CLI, IDE extension, Cloud, SDK
Definition
Codex review of changes or feedback on a pull request.
Applies to
Desktop app, CLI, GitHub
Term
RBAC
Definition
Role-based access control for workspace permissions.
Applies to
Enterprise
Definition
Mode where Codex can inspect but not modify without approval.
Applies to
Desktop app, CLI, IDE extension
Definition
Setting that controls how much reasoning budget a model uses.
Applies to
Desktop app, CLI, IDE extension, SDK
Definition
Connection that lets you access Work or Codex tasks on another device through a connected host.
Applies to
Desktop app, Mobile
Definition
Admin-enforced requirements file for managed Codex setups.
Applies to
Enterprise
Definition
Desktop app view for inspecting diffs, comments, and Git changes.
Applies to
Desktop app
Term
Rules
Definition
Policies that allow, prompt for, or deny command prefixes or permission exceptions.
Applies to
Desktop app, CLI, IDE extension
Definition
Enforced boundary limiting what Codex commands can access or modify.
Applies to
Desktop app, CLI, IDE extension
Definition
Configuration that defines Codex's filesystem and network limits.
Applies to
Desktop app, CLI, IDE extension
Definition
SDK shorthand for common sandbox policies such as read-only, workspace-write, or full access.
Applies to
SDK
Definition
The timing rule for a scheduled task.
Applies to
Desktop app
Definition
One execution of a scheduled task that may report findings or archive itself.
Applies to
Desktop app, Web
Definition
A scheduled or recurring task in ChatGPT.
Applies to
Desktop app, Web
Definition
Work scheduled from an existing task that returns to the same task context on each scheduled run.
Applies to
Desktop app, Web
Term
Secret
Definition
Encrypted value available to setup scripts but removed before the agent phase.
Applies to
Cloud
Definition
Script run before the agent starts to install dependencies or prepare tools.
Applies to
Desktop app worktrees
Term
Skill
Definition
Reusable workflow package with instructions and optional scripts or references.
Applies to
Desktop app, CLI, IDE extension
Definition
Explicit or implicit activation of a skill.
Applies to
Desktop app, CLI, IDE extension
Definition
Command entered with a leading slash to control or inspect a Codex CLI session.
Applies to
CLI
Definition
Scheduled task whose runs each start a new task and report findings in Triage.
Applies to
Desktop app, Web
Definition
MCP server launched as a local process by a configured command and arguments.
Applies to
CLI, IDE extension
Definition
MCP server reached over HTTP, optionally with bearer token or OAuth authentication.
Applies to
CLI, IDE extension
Definition
Specialized child agent spawned to work on part of a task.
Applies to
Desktop app, CLI
Definition
Workflow where Codex runs delegated agents in parallel and combines their results.
Applies to
Desktop app, CLI
Term
Task
Definition
Durable unit of Work or Codex activity containing its context, messages, results, and actions.
Applies to
Desktop app, Web, Mobile, CLI, IDE extension, Cloud
Term
Thread
Definition
Technical conversation object exposed by Codex app-server APIs and protocol fields.
Applies to
App-server, SDK
Definition
New thread branched from the stored history of an existing thread.
Applies to
App-server, SDK
Term
Turn
Definition
One exchange in a chat or task, usually a user prompt plus the agent's response and actions.
Applies to
Desktop app, CLI, IDE extension, Cloud, SDK
Definition
Default Codex cloud container image with common tools preinstalled.
Applies to
Cloud
Definition
Pre-indexed search results Codex can use without live browsing.
Applies to
Desktop app, CLI, IDE extension
Term
Work
Definition
ChatGPT Work is an agent for research, analysis, and creating documents, presentations, spreadsheets, and other finished work.
Applies to
Desktop app, Web
Definition
Mode where Codex isolates changes in a separate Git worktree.
Applies to
Desktop app
Definition
Directories Codex is allowed to modify.
Applies to
Desktop app, CLI, IDE extension