Function main

examples/tools/codex.py:104–161

()

async def main() -> None:
    agent = Agent(
        name="Codex Agent",
        instructions=(
            "Use the codex tool to inspect the workspace in read-only mode and answer the question. "
            "When skill names, which usually starts with `$`, are mentioned, "
            "you must rely on the codex tool to use the skill and answer the question.\n\n"
            "When you send the final answer, you must include the following info at the end:\n\n"
            "Run `codex resume <thread_id>` to continue the codex session."
        ),
        tools=[
            # Run local Codex CLI as a sub process
            codex_tool(
                sandbox_mode="read-only",
                default_thread_options=ThreadOptions(
                    # You can pass a Codex instance to customize CLI details
                    # codex=Codex(executable_path="/path/to/codex", base_url="..."),
                    model="gpt-5.5",
                    model_reasoning_effort="low",
                    network_access_enabled=True,
                    web_search_enabled=False,
                    approval_policy="never",  # We'll update this example once the HITL is implemented
                ),
                default_turn_options=TurnOptions(
                    # Abort Codex CLI if no events arrive within this many seconds.
                    idle_timeout_seconds=60,
                ),
                on_stream=on_codex_stream,
            )
        ],
    )
    trace_id = gen_trace_id()
    log(f"View trace: https://platform.openai.com/traces/trace?trace_id={trace_id}")

    with trace("Codex tool example", trace_id=trace_id):
        log("Using the Codex tool to inspect pyproject.toml and summarize Python requirements...")
        result = await Runner.run(
            agent,
            (
                "Inspect pyproject.toml in this repository and summarize the supported Python "
                "version plus the main local test command. Do not modify any files."
            ),
        )
        log(result.final_output)

        # Use local inspection in read-only mode.
        log(
            "Using the Codex tool to inspect AGENTS.md and summarize the local verification workflow..."
        )
        result = await Runner.run(
            agent,
            (
                "Inspect AGENTS.md and summarize the mandatory local verification commands for this "
                "repository. Do not modify any files or suggest code changes."
            ),
        )
        log(result.final_output)
        # (A read-only summary of the local verification workflow will be displayed.)