Harness reference

Codex harness reference

OpenAI documents Codex as a coding agent that can read, edit, and run code across web, IDE, and CLI surfaces.

Identity

These notes are intentionally narrow. They are derived from linked official sources and should not be expanded by implication.

Codex web can work on tasks in the background using a cloud environment.
The IDE extension can pair with Codex locally or delegate tasks to Codex Cloud.
The CLI can inspect a repository, edit files, and run commands from a terminal session.

Use the `codex` harness ID only when the product task should return code-related work your app can review.

Run payload

await hr.run({
  harness: "codex",
  task: "Describe the product work the user asked for"
});

Keep this backend-facing.

Users should choose product actions. Your server maps those actions to allowed harness IDs.

Read the official pages before making capability claims in product UI.