Codex

Use Codex with Steel CLI to scrape pages, run browser sessions, and automate browser workflows from the terminal.

Overview

The Codex integration uses Steel CLI as a terminal tool inside Codex with the help of steel-browser agent skill. This lets Codex:

  • Start and control Steel browser sessions from the Codex session
  • Scrape fully rendered pages and perform computer-use actions
  • Inspect live browser state with snapshots and the Steel session viewer
  • Turn one-off browser runs into reusable scripts

Codex and Steel fit together well because both are command-line tools. Once Steel CLI is installed and available on PATH, Codex can inspect command help, run the commands it needs, and verify results from the terminal.

Requirements

  • Node.js: Version 18 or higher
  • Codex CLI: Installed locally
  • Steel CLI: Installed locally
  • Steel API Key: Active Steel account

Setup

Step 1: Install Steel CLI

Terminal
curl -LsSf https://setup.steel.dev | sh

Step 2: Log in

Terminal
steel login

The steel-browser skill gives Codex better command discovery and more consistent browser workflows.

Terminal
npx skills add https://github.com/steel-dev/cli --skill steel-browser

Restart Codex after installing so it can discover the skill.

This gives Codex a real browser loop for navigation, clicking, form entry, and session-aware browsing.

Automation workflow

After a successful manual run, you can ask Codex to turn the workflow into a script:

Write a bash script based on what you just did.

That works well for jobs like recurring research, internal reporting, or lightweight monitoring. A common pattern is:

  1. 1Run the task once interactively
  2. 2Convert it into a script
  3. 3Schedule it with cron or another runner

Constraints

  • Command approvals depend on your Codex settings. Codex may ask before running shell commands unless you have configured a more permissive approval mode.
  • Authenticated workflows usually need preconfigured Steel auth state. For reusable login state, see Profiles API and Reusing Auth Context.

Additional Resources

Contents

OverviewRequirementsSetupStep 1: Install Steel CLIStep 2: Log inStep 3: Install the browser skill (recommended)Automation workflowConstraintsAdditional Resources