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