Skip to main content
The features command allows you to view, enable, and disable experimental and beta features in Codex.

​
Usage

codex features <SUBCOMMAND>

​
Subcommands

​
list

List all available feature flags with their current state: 
codex features list

​
enable

Enable a specific feature flag: 
codex features enable <FEATURE_NAME>

​
disable

Disable a specific feature flag: 
codex features disable <FEATURE_NAME>

​
Examples

​
View All Features

codex features list
Output shows:
  • Feature name
  • Current state (enabled/disabled)
  • Stage (stable, beta, experimental, under development)
  • Description

​
Enable Experimental Feature

codex features enable js_repl

​
Disable Feature

codex features disable multi_agent

​
Use Feature for Single Command

Instead of permanently enabling a feature, use the --enable flag: 
codex --enable js_repl exec "run this code in a REPL"

​
Feature Stages

Features go through different stages of development:
StageDescriptionStability
stableProduction-ready, enabled by defaultHigh
betaGenerally stable, ready for testingMedium
experimentalEarly development, may changeLow
under developmentNot ready for useVery low
deprecatedBeing phased outN/A

​
Common Features

​
Experimental Features

  • js_repl - JavaScript REPL environment
  • multi_agent - Multi-agent collaboration
  • apps - ChatGPT apps integration
  • prevent_idle_sleep - Prevent system sleep during long operations

​
Stable Features

  • shell_tool - Enhanced shell command execution
  • unified_exec - Unified execution engine
  • shell_snapshot - Shell command snapshots
  • sqlite - SQLite-backed state storage
  • personality - Agent personality customization

​
Configuration

Feature flags can also be set in ~/.codex/config.toml: 
[features]
js_repl = true
multi_agent = false

​
Priority Order

Feature flags are resolved in this order (highest to lowest):
  1. Command-line flags (--enable, --disable)
  2. Environment variables (CODEX_ENABLE_<FEATURE>)
  3. Config file (~/.codex/config.toml)
  4. Default value

​
Warnings

Experimental features may:
  • Change behavior without notice
  • Be removed in future versions
  • Cause unexpected errors
  • Affect performance
Beta features are more stable but may still undergo breaking changes before becoming stable.

Feature Flags Reference

Complete list of all feature flags

Configuration

Configure Codex settings

Build docs developers (and LLMs) love

Get started for freeTalk to us