Skip to content
Registry

codex

v0.1.2

OpenAI Codex as an iii worker; codex::run/start/stop/status/sessions::list spawn the codex CLI for headless turns, deliver raw thread events on the codex::raw-event trigger type and AgentEvent frames on codex::agent-event.

Install

bash
iii trigger compose::add worker=codex@0.1.2

Run in your project with the iii engine running. Exact versions are immutable and digest-pinned.

Functions6

codex::on-config-change

Function

Internal: reload codex configuration when it changes.

Request
valueunknown
Response
valueunknown

codex::run

Function

Run one Codex turn and wait for the result. Accepts `prompt` or a `messages` array plus a raw SDK `codex_config` pass-through; streams raw Codex events onto codex::events, AgentEvent frames onto agent::events, and returns {session_id, result, usage}.

Request
valueunknown
Response
valueunknown

codex::sessions::list

Function

List every Codex session this worker has run.

Request
valueunknown
Response
valueunknown

codex::start

Function

Start a Codex turn and return immediately; watch codex::events / agent::events (group_id = session_id) for progress and turn_end.

Request
valueunknown
Response
valueunknown

codex::status

Function

Point-in-time status of a Codex session.

Request
valueunknown
Response
valueunknown

codex::stop

Function

Interrupt a live Codex run for a session.

Request
valueunknown
Response
valueunknown

Triggers0

No triggers registered

Search the registry

Find workers, kits and executables, or jump to a page.