메뉴
Run headless OpenAI Codex turns over the iii bus — sandboxed shell, file edits, and web search against any host directory — with verbatim event streaming, thread resume, and full SDK option pass-through.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
| name | codex |
| description | Run headless OpenAI Codex turns over the iii bus — sandboxed shell, file edits, and web search against any host directory — with verbatim event streaming, thread resume, and full SDK option pass-through. |
The codex worker exposes the OpenAI Codex API as iii functions. One
codex::run call executes one headless Codex turn — the same agent the user
runs in their terminal, with the same login, filesystem, and sandbox — in a
chosen working directory, and returns the final result and token usage. The
worker is a pure pass-through: named payload fields cover the common path,
the options field forwards any Codex SDK ThreadOption verbatim, and every
thread event mirrors untouched onto the codex::events stream. A translated
AgentEvent view lands on agent::events, which is what the iii console
renders.
Requires the codex CLI on the host with an existing codex login or
OPENAI_API_KEY in the worker environment. When a turn needs a capability
beyond Codex itself, add another iii worker to the bus instead of bolting
anything onto this one.
coder::* / shell::* calls
yourself: codex::run with prompt and cwd.session_id again and
the worker resumes the underlying Codex thread with full context.codex::start returns
{session_id, started} immediately; follow codex::events (group_id =
session_id) for raw progress or agent::events for the rendered view;
interrupt with codex::stop.developer_instructions), so the agent discovers and
calls any registered function through the iii CLI
(engine::functions::list, iii trigger <fn> --help); disable per turn
with iii_context: false.sandbox_mode: read-only (writes physically fail), read the plan, then
send "implement the plan" on the same session_id with
sandbox_mode: workspace-write.output_schema (JSON schema) and the
final agent message is JSON matching it.images: ["/path/a.png"] adds local
images to the prompt.codex_config
forwards any config.toml override, e.g.
{"codex_config": {"mcp_servers": {"github": {"command": "gh-mcp"}}}}.options unchanged, e.g.
{"options": {"networkAccessEnabled": true, "webSearchMode": "live"}}.codex CLI per turn — needs Codex installed and
authenticated; not available inside a bare container without it.sandbox_mode), not the
engine's: read-only blocks writes, workspace-write allows edits in
cwd, danger-full-access disables the sandbox. Headless turns run
approval_policy: never, so blocked commands fail instead of prompting.codex::status (live: true)
before sending another codex::run for the same session_id; parallel
runs against one session race on the underlying thread resume.agent::events carries whole-message frames; per-item progress detail
(command output as it accumulates, todo lists) exists only on
codex::events.codex::run — run one Codex turn and wait; accepts prompt (or a
messages array whose last user entry becomes the prompt), plus model,
cwd, sandbox_mode, approval_policy, reasoning_effort,
skip_git_repo_check, output_schema, and raw options; returns
{session_id, codex_thread_id, result, stop_reason, usage}.codex::start — same payload, returns {session_id, started}
immediately; progress arrives on the streams.codex::stop — interrupt the live run for a session.codex::status — point-in-time session view: live flag, status, turns,
usage.codex::sessions::list — every session this worker has run.SOC 직업 분류 기준
Run Unix commands and structured filesystem ops from the iii engine: exec, background jobs, and a structured fs (ls/stat/mkdir/rm/chmod/mv/grep/sed/ read/write, jailed only if fs.host_roots is configured), all forwardable into a sandbox microVM.
Shared, adapter-backed key/value store addressed by scope and key, with a reactive `state` trigger so other functions can run on every create, update, or delete without polling.
Durable topic queues for iii: subscribe functions to topics, publish work asynchronously, retry failed deliveries with backoff, and inspect/redrive dead-lettered messages.
Mint isolated git worktrees for parallel agent work, track ownership in a cross-agent registry, and land finished branches back onto a target with a queued rebase, test gate, and atomic fast-forward merge.
Connect this engine to another iii engine over a long-lived WebSocket so functions call across the boundary. Wire stable ids with `forward:`/`expose:`; `bridge.invoke` is the ad-hoc escape hatch.
Drive Devin over the iii bus. Run the local Devin CLI agent (SWE-1.6) with the iii runtime context so it discovers and operates your mesh, or start and steer autonomous Devin cloud sessions through the REST API, with a passthrough to any Devin v1/v3 endpoint.
