Skip to main content

OpenAI Codex Setup

OpenAI Codex is the main OpenAI-based technical agent workflow that Automation Agent for Adobe Premiere currently supports with a low-friction guided setup.

This page is for the Codex / Claude Code mode in the Automation Agent panel, which uses the panel-managed local HTTP MCP server.

Use this path when you want Codex as the Assistant that inspects Premiere project state through MCP, validates Runtime DSL, and runs permission-scoped workflows with the Automation Agent guidance layer installed.

Codex can also be configured as Workflow AI. In that role, a saved workflow can call the Codex CLI later from an askAgent step.

If the two roles are new to you, read AI Setup Roles first.

Which Role Does This Set Up?​

RoleSupported with Codex?What needs to be configured
AssistantyesCodex MCP config plus the Automation Agent Codex skill
Workflow AIyesCodex CLI executable, codex login, provider profile, and provider test

You can configure either role by itself, but many users will want both.

On macOS, the Codex desktop app may already include a runnable codex binary that Automation Agent can use for Workflow AI. On Windows, you should expect to install the Codex CLI separately if you want Workflow AI.

What You Need​

For Codex as your Assistant, three things need to be true at the same time:

  1. the local Automation Agent MCP server is available
  2. Codex has an MCP server entry for Automation Agent
  3. the Automation Agent Codex skill is installed

Starting MCP alone is not enough. Without the MCP config, Codex cannot reach the local server. Without the skill, Codex can still talk to MCP, but it will usually make weaker assumptions about discovery, validation, and Premiere-specific authoring.

For Codex as Workflow AI, these things need to be true:

  1. a runnable Codex CLI executable is available
  2. Codex CLI is authenticated with codex login
  3. Automation Agent has a saved Codex CLI Workflow AI provider profile
  4. the provider test passes in AI Setup

Best Setup Path​

The easiest setup path is from inside the Automation Agent panel:

  1. open AI Setup
  2. click Start Guided Setup
  3. choose OpenAI / ChatGPT
  4. follow the Codex Assistant and Codex Workflow AI steps

The manual setup path is:

  1. open the MCP Server tab
  2. start or connect MCP
  3. open the Agent Setup section
  4. use Configure MCP
  5. use Install Codex Skill
  6. restart Codex
  7. return to the panel and verify the status

For Workflow AI, use AI Setup > Workflow AI or Advanced Provider Setup:

  1. find or select the Codex CLI executable
  2. run codex login if Codex CLI is not authenticated yet
  3. use Test & Save

Important:

  • use the panel in Codex / Claude Code mode
  • that mode uses the panel-managed HTTP MCP server
  • this is different from Claude Desktop Chat, which uses a client-launched local stdio runtime

Where The MCP Config Lives​

Codex MCP configuration is stored in:

~/.codex/config.toml

The relevant Automation Agent entry looks like:

[mcp_servers.automation_blocks]
url = "http://127.0.0.1:53125/mcp"

What The Installer Writes​

The Codex skill is installed to:

~/.codex/skills/automation-agent/

That folder should contain:

  • SKILL.md
  • agents/openai.yaml
  • references/...

If Codex Was Already Open​

Restart Codex after installing or updating the skill. Otherwise it may continue using the previous state or fail to pick up the skill at all.

Workflow AI Notes​

Codex Workflow AI is used by saved workflows, not by the live chat session itself.

For example, a saved workflow might use Premiere and Automation Agent blocks to collect transcript text, then call Codex CLI only for a bounded reasoning step such as summarizing, classifying, proofreading, or returning structured text.

If a provider test fails, check:

  • the selected executable path
  • that codex login has completed
  • whether Codex can be run from the same user account that runs Automation Agent

If The Panel Says The Packaged Skill Is Missing​

That usually means the current plugin build does not include the generated Codex skill export yet.

In development, rebuild the product assets and the plugin package, then reopen the panel.