{
  "id": "agentVersion:codex:ge-0-119-0",
  "_kind": "AgentVersion",
  "_file": "agent-stack/versions/codex-1-x.yaml",
  "_cluster": "agent-stack",
  "attributes": {
    "agentId": "codex",
    "aliases": [],
    "runtimeFamily": "cli-harness",
    "releaseChannel": "stable",
    "displayName": "Codex CLI",
    "summary": "OpenAI's open-source CLI coding agent, assimilated through 0.135.0",
    "sourcePackage": "@openai/codex",
    "osSupport": [
      "linux",
      "macos",
      "windows"
    ],
    "agentProductId": "agent:codex",
    "versionRange": ">=0.119.0",
    "currentVersion": "0.135.0",
    "releasedAt": "2026-05-28",
    "upstreamReleaseTag": "rust-v0.135.0",
    "releaseNotesUrl": "https://github.com/openai/codex/releases/tag/rust-v0.135.0",
    "assimilationNotes": [
      "codex doctor now reports richer environment, Git, terminal, app-server, and thread inventory diagnostics.",
      "/status now shows remote connection details and server version when connected over a remote transport.",
      "Vim mode adds text-object editing, improved word/line-end behavior, and a configurable interrupt-turn binding.",
      "/permissions understands named permission profiles and displays configured custom profiles.",
      "Packaged builds can discover and use the bundled patched zsh helper on supported macOS and Linux targets.",
      "Resume flows include non-interactive exec sessions when requested and honor cwd overrides for idle cached threads.",
      "Runtime state for memories moved into a dedicated SQLite database.",
      "Local conversation history search now includes case-insensitive content matches with previews.",
      "--profile is now the primary selector across CLI, TUI permissions, and sandbox flows; legacy profile configs are rejected with migration guidance.",
      "MCP setup adds per-server environment targeting and OAuth options for streamable HTTP servers.",
      "Connector tool schemas preserve local $ref/$defs structures and compact oversized schemas before exposure.",
      "Read-only MCP tools can run concurrently when readOnlyHint is advertised.",
      "Extensions and hooks receive richer context, including conversation history for extension tools and subagent identity in hook inputs.",
      "Remote control reliability improved by reconnecting stale exec-server websocket clients, retrying after auth recovery, and retrying remote compaction v2 streams.",
      "Node-based tools honor Codex's managed network proxy environment.",
      "Goals are default-on in 0.133.0 and backed by dedicated storage.",
      "codex remote-control is modeled as foreground readiness plus explicit start/stop lifecycle commands.",
      "Permission profiles expose list APIs, inheritance, requirements.toml support, runtime refresh, and stronger Windows sandbox integration.",
      "Plugin discovery reports marketplace-aware list output, installed versions, marketplace roots, and remote collections.",
      "Extensions can observe subagent lifecycle, tool execution, turn metadata, async approval, and turn processing.",
      "App-server fixes include startup/shutdown race fixes and realtime v1 websocket compatibility."
    ],
    "goals": {
      "defaultEnabled": true,
      "storage": "dedicated-goal-store",
      "progressScope": "active-turns"
    },
    "remoteControl": {
      "launchBehavior": "foreground-readiness",
      "reportsMachineStatus": true,
      "explicitLifecycleCommands": [
        "start",
        "stop"
      ]
    },
    "permissionProfiles": {
      "listApi": true,
      "inheritance": true,
      "requirementsToml": "managed",
      "runtimeRefresh": true,
      "windowsSandboxIntegration": "resolved-profiles"
    },
    "pluginDiscovery": {
      "marketplaceAwareListOutput": true,
      "installedVersions": true,
      "visibleMarketplaceRoots": true,
      "remoteCollections": true,
      "marketplaceCli": "codex plugin marketplace",
      "marketplaceCliCommands": [
        "add",
        "list",
        "upgrade",
        "remove"
      ],
      "pluginManifestPath": ".codex-plugin/plugin.json",
      "marketplacePaths": {
        "primary": ".agents/plugins/marketplace.json",
        "legacy": ".claude-plugin/marketplace.json"
      },
      "pluginCacheDir": "~/.codex/plugins/cache/$MARKETPLACE/$PLUGIN/$VERSION/",
      "hookDiscovery": {
        "autoDetect": "./hooks/hooks.json",
        "manifestField": "hooks",
        "manifestFieldFormats": [
          "path",
          "array-of-paths",
          "inline-object",
          "array-of-objects"
        ]
      },
      "hookEnvVars": {
        "native": [
          "PLUGIN_ROOT",
          "PLUGIN_DATA"
        ],
        "compatAliases": [
          "CLAUDE_PLUGIN_ROOT",
          "CLAUDE_PLUGIN_DATA"
        ]
      }
    },
    "extensionEvents": {
      "observesSubagentLifecycle": true,
      "observesToolExecution": true,
      "observesTurnMetadata": true,
      "asyncApproval": true,
      "asyncTurnProcessing": true
    },
    "appServer": {
      "startupRaceFix": true,
      "shutdownRaceFix": true,
      "realtimeV1WebsocketCompatible": true
    },
    "cliCommand": "codex",
    "installMethods": [
      "install:npm"
    ],
    "minSchemaVersion": "6.0.0",
    "interactiveSignals": {
      "turnCompletePattern": "codex>",
      "exitOnNonInteractive": true,
      "nonInteractiveMode": "exec",
      "interactiveMode": ""
    },
    "adapterMetadata": {
      "installCommands": [
        {
          "type": "npm",
          "command": "npm install -g @openai/codex"
        },
        {
          "type": "marketplace",
          "command": "codex plugin marketplace add <plugin-name>"
        }
      ],
      "authMethods": [
        {
          "type": "api_key",
          "name": "API Key",
          "envVars": [
            "OPENAI_API_KEY"
          ]
        }
      ],
      "authFiles": [
        "~/.codex/config.json"
      ],
      "hostEnvSignals": [
        "CODEX_SESSION_ID",
        "CODEX_RUN_ID",
        "CODEX_CLI"
      ],
      "sessionDir": "~/.codex/sessions",
      "sessionPersistence": "file",
      "approvalModes": [
        "yolo",
        "prompt",
        "deny"
      ],
      "capabilityFlags": {
        "canResume": true,
        "canFork": false,
        "supportsMultiTurn": true,
        "sessionPersistence": "file",
        "supportsTextStreaming": true,
        "supportsToolCallStreaming": true,
        "supportsThinkingStreaming": false,
        "supportsNativeTools": true,
        "supportsMCP": false,
        "supportsParallelToolCalls": true,
        "requiresToolApproval": true,
        "supportsThinking": false,
        "supportsJsonMode": true,
        "supportsStructuredOutput": true,
        "structuredSessionTransport": "restart-per-turn",
        "sessionControlPlane": "self-managed",
        "supportsSkills": true,
        "supportsAgentsMd": true,
        "skillsFormat": "codex-skills",
        "supportsSubagentDispatch": false,
        "supportsParallelExecution": false,
        "maxParallelTasks": 1,
        "supportsInteractiveMode": false,
        "supportsStdinInjection": false,
        "supportsImageInput": false,
        "supportsImageOutput": false,
        "supportsFileAttachments": false,
        "supportsPlugins": true,
        "supportsPluginMarketplace": true,
        "supportedPlatforms": [
          "darwin",
          "linux",
          "win32"
        ],
        "thinkingEffortLevels": [],
        "requiresGitRepo": false,
        "requiresPty": false
      },
      "goals": {
        "defaultEnabled": true,
        "storage": "dedicated-goal-store",
        "progressScope": "active-turns"
      },
      "remoteControl": {
        "launchBehavior": "foreground-readiness",
        "reportsMachineStatus": true,
        "explicitLifecycleCommands": [
          "start",
          "stop"
        ]
      },
      "permissionProfiles": {
        "listApi": true,
        "inheritance": true,
        "requirementsToml": "managed",
        "runtimeRefresh": true,
        "windowsSandboxIntegration": "resolved-profiles"
      },
      "pluginDiscovery": {
        "marketplaceAwareListOutput": true,
        "installedVersions": true,
        "visibleMarketplaceRoots": true,
        "remoteCollections": true,
        "marketplaceCli": "codex plugin marketplace",
        "marketplaceCliCommands": [
          "add",
          "list",
          "upgrade",
          "remove"
        ],
        "pluginManifestPath": ".codex-plugin/plugin.json",
        "marketplacePaths": {
          "primary": ".agents/plugins/marketplace.json",
          "legacy": ".claude-plugin/marketplace.json"
        },
        "pluginCacheDir": "~/.codex/plugins/cache/$MARKETPLACE/$PLUGIN/$VERSION/",
        "hookDiscovery": {
          "autoDetect": "./hooks/hooks.json",
          "manifestField": "hooks",
          "manifestFieldFormats": [
            "path",
            "array-of-paths",
            "inline-object",
            "array-of-objects"
          ]
        },
        "hookEnvVars": {
          "native": [
            "PLUGIN_ROOT",
            "PLUGIN_DATA"
          ],
          "compatAliases": [
            "CLAUDE_PLUGIN_ROOT",
            "CLAUDE_PLUGIN_DATA"
          ]
        }
      },
      "extensionEvents": {
        "observesSubagentLifecycle": true,
        "observesToolExecution": true,
        "observesTurnMetadata": true,
        "asyncApproval": true,
        "asyncTurnProcessing": true
      },
      "appServer": {
        "startupRaceFix": true,
        "shutdownRaceFix": true,
        "realtimeV1WebsocketCompatible": true
      },
      "runtimeHooks": {
        "preToolUse": "nonblocking",
        "postToolUse": "nonblocking",
        "sessionStart": "nonblocking",
        "sessionEnd": "nonblocking",
        "stop": "nonblocking",
        "userPromptSubmit": "nonblocking"
      },
      "configSchema": {
        "configFormat": "json",
        "configFilePaths": [
          "~/.codex/config.json"
        ]
      },
      "displayName": "OpenAI Codex",
      "defaultModelId": "o4-mini"
    },
    "hookSupport": {
      "interactive": {
        "sessionStart": "native",
        "stop": "native",
        "userPromptSubmit": "native",
        "preToolUse": "native",
        "sessionEnd": "native"
      },
      "nonInteractive": {
        "sessionStart": "emulated",
        "stop": "unsupported",
        "userPromptSubmit": "unsupported",
        "preToolUse": "unsupported",
        "sessionEnd": "unsupported"
      }
    },
    "bridgeCapabilities": {
      "interactiveBridge": true,
      "hookBridge": true,
      "sessionResume": false,
      "positionalPrompt": true,
      "nonInteractiveUsesExecMode": true
    }
  },
  "outgoingEdges": [
    {
      "from": "agentVersion:codex:ge-0-119-0",
      "to": "agent:codex",
      "kind": "version_of"
    },
    {
      "from": "agentVersion:codex:ge-0-119-0",
      "to": "agent-core-impl:codex.core@1.x",
      "kind": "composed_of",
      "attributes": {
        "role": "core"
      }
    },
    {
      "from": "agentVersion:codex:ge-0-119-0",
      "to": "agent-runtime-impl:codex.runtime@1.x",
      "kind": "composed_of",
      "attributes": {
        "role": "runtime"
      }
    },
    {
      "from": "agentVersion:codex:ge-0-119-0",
      "to": "agent-platform-impl:codex.platform@1.x",
      "kind": "composed_of",
      "attributes": {
        "role": "platform"
      }
    },
    {
      "from": "agentVersion:codex:ge-0-119-0",
      "to": "agent-ui-impl:codex.ui@current",
      "kind": "composed_of",
      "attributes": {
        "role": "ui"
      }
    },
    {
      "from": "agentVersion:codex:ge-0-119-0",
      "to": "knowledge-fabric-impl:codex.knowledge@current",
      "kind": "composed_of",
      "attributes": {
        "role": "knowledge-fabric"
      }
    },
    {
      "from": "agentVersion:codex:ge-0-119-0",
      "to": "memory-system:codex-agents-md",
      "kind": "uses_memory_system",
      "attributes": {}
    },
    {
      "from": "agentVersion:codex:ge-0-119-0",
      "to": "launch-contract:codex-default",
      "kind": "has_launch_contract",
      "attributes": {}
    },
    {
      "from": "agentVersion:codex:ge-0-119-0",
      "to": "transport-runtime:terminal-cli",
      "kind": "uses_transport"
    },
    {
      "from": "agentVersion:codex:ge-0-119-0",
      "to": "transport-runtime:shell-hook-runtime",
      "kind": "uses_transport"
    },
    {
      "from": "agentVersion:codex:ge-0-119-0",
      "to": "transportProtocol:terminal-cli",
      "kind": "uses_transport"
    },
    {
      "from": "agentVersion:codex:ge-0-119-0",
      "to": "transportProtocol:shell-hook-runtime",
      "kind": "uses_transport"
    },
    {
      "from": "agentVersion:codex:ge-0-119-0",
      "to": "modality:image",
      "kind": "supports_modality"
    },
    {
      "from": "agentVersion:codex:ge-0-119-0",
      "to": "modality:text",
      "kind": "supports_modality"
    },
    {
      "from": "agentVersion:codex:ge-0-119-0",
      "to": "modelVersion:codex-default:ge-0-0-0",
      "kind": "defaults_to_model"
    },
    {
      "from": "agentVersion:codex:ge-0-119-0",
      "to": "plugin-target:codex",
      "kind": "targets_plugin_surface"
    },
    {
      "from": "agentVersion:codex:ge-0-119-0",
      "to": "discovery-signal:codex-host-env",
      "kind": "discovered_by"
    },
    {
      "from": "agentVersion:codex:ge-0-119-0",
      "to": "capability:supports-agents-md",
      "kind": "supports",
      "attributes": {
        "versionRange": ">=0.119.0",
        "level": "full",
        "notes": "Codex CLI reads AGENTS.md as long-term memory at session bootstrap, with 0.133.0 fixes for global reads and invalid UTF-8 warnings."
      }
    },
    {
      "from": "agentVersion:codex:ge-0-119-0",
      "to": "capability:requires-pty",
      "kind": "supports",
      "attributes": {
        "versionRange": ">=0.119.0",
        "level": "partial",
        "notes": "Interactive TUI mode requires PTY; --quiet / scripted mode does not."
      }
    },
    {
      "from": "agentVersion:codex:ge-0-119-0",
      "to": "capability:supports-file-attachments",
      "kind": "supports",
      "attributes": {
        "versionRange": ">=0.119.0",
        "level": "partial",
        "notes": "TUI accepts pasted content; image attachments via --add-image."
      }
    },
    {
      "from": "agentVersion:codex:ge-0-119-0",
      "to": "install:npm",
      "kind": "installed_via"
    }
  ],
  "incomingEdges": [
    {
      "from": "knowledge-fabric-impl:codex.knowledge@current",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "composes",
      "attributes": {
        "role": "knowledge-fabric"
      }
    },
    {
      "from": "agent:codex",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "has_version"
    },
    {
      "from": "capabilitySupport:codex:ge-0-119-0:skills",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "capability_of_version",
      "attributes": {}
    },
    {
      "from": "capabilitySupport:codex:ge-0-119-0:thinking",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "capability_of_version",
      "attributes": {}
    },
    {
      "from": "capabilitySupport:codex:ge-0-119-0:interactive-mode",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "capability_of_version",
      "attributes": {}
    },
    {
      "from": "capabilitySupport:codex:ge-0-119-0:stdin-injection",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "capability_of_version",
      "attributes": {}
    },
    {
      "from": "capabilitySupport:codex:ge-0-119-0:image-input",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "capability_of_version",
      "attributes": {}
    },
    {
      "from": "capabilitySupport:codex:ge-0-119-0:runtime-hooks",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "capability_of_version",
      "attributes": {}
    },
    {
      "from": "capabilitySupport:codex:ge-0-119-0:stop-hook",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "capability_of_version",
      "attributes": {}
    },
    {
      "from": "capabilitySupport:codex:ge-0-119-0:session-resume",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "capability_of_version",
      "attributes": {}
    },
    {
      "from": "evidence:codex-rust-v0-134-0-release",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "references"
    },
    {
      "from": "evidence:codex-rust-v0-135-0-release",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "references"
    },
    {
      "from": "evidence:codex-rust-v0-135-0-issue-802",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "references"
    },
    {
      "from": "evidence:web-codex-0-135-release",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "references"
    },
    {
      "from": "hook-mapping:stop-codex",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "emits_hook",
      "attributes": {}
    },
    {
      "from": "hook-mapping:pre-tool-use-codex",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "emits_hook",
      "attributes": {}
    },
    {
      "from": "hook-mapping:codex-on-stop-native",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "emits_hook",
      "attributes": {}
    },
    {
      "from": "hook-mapping:codex-on-tool-call-native",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "emits_hook",
      "attributes": {}
    },
    {
      "from": "hook-surface:codex.on-tool-call",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "emits_hook",
      "attributes": {
        "attrs": {
          "since": "1.0.0"
        }
      }
    },
    {
      "from": "agent-host-transport:terminal-cli",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "used_by"
    },
    {
      "from": "agent-host-transport:stdio",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "used_by"
    },
    {
      "from": "install:npm",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "installs"
    },
    {
      "from": "adapter:agent-launch-adapter",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "bridges_for",
      "attributes": {}
    },
    {
      "from": "adapter:agent-comm-adapter",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "bridges_for",
      "attributes": {}
    },
    {
      "from": "adapter:session-storage-adapter",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "bridges_for",
      "attributes": {}
    },
    {
      "from": "adapter:agent-config-adapter",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "bridges_for",
      "attributes": {}
    },
    {
      "from": "adapter:hooks-adapter",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "bridges_for",
      "attributes": {}
    },
    {
      "from": "adapter:extensions-adapter",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "bridges_for",
      "attributes": {}
    },
    {
      "from": "adapter:tools-adapter",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "bridges_for",
      "attributes": {}
    },
    {
      "from": "adapter:agent-launch-adapter",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "bridges_for",
      "attributes": {}
    },
    {
      "from": "adapter:agent-comm-adapter",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "bridges_for",
      "attributes": {}
    },
    {
      "from": "adapter:session-storage-adapter",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "bridges_for",
      "attributes": {}
    },
    {
      "from": "adapter:agent-config-adapter",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "bridges_for",
      "attributes": {}
    },
    {
      "from": "adapter:hooks-adapter",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "bridges_for",
      "attributes": {}
    },
    {
      "from": "adapter:extensions-adapter",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "bridges_for",
      "attributes": {}
    },
    {
      "from": "adapter:tools-adapter",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "bridges_for",
      "attributes": {}
    },
    {
      "from": "adapter:agent-launch-adapter",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "bridges_for",
      "attributes": {}
    },
    {
      "from": "adapter:agent-comm-adapter",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "bridges_for",
      "attributes": {}
    },
    {
      "from": "adapter:session-storage-adapter",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "bridges_for",
      "attributes": {}
    },
    {
      "from": "adapter:agent-config-adapter",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "bridges_for",
      "attributes": {}
    },
    {
      "from": "adapter:hooks-adapter",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "bridges_for",
      "attributes": {}
    },
    {
      "from": "adapter:extensions-adapter",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "bridges_for",
      "attributes": {}
    },
    {
      "from": "adapter:tools-adapter",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "bridges_for",
      "attributes": {}
    },
    {
      "from": "plugin:example-portable-extension",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "compiles_to",
      "attributes": {}
    },
    {
      "from": "workflow:linear-default",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "invokes_agent",
      "attributes": {}
    },
    {
      "from": "lifecycle-semantics:codex",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "applies_to_version",
      "attributes": {}
    },
    {
      "from": "session-semantics:codex",
      "to": "agentVersion:codex:ge-0-119-0",
      "kind": "applies_to_version",
      "attributes": {}
    }
  ]
}