mirror of
https://github.com/openai/codex.git
synced 2026-11-18 22:20:48 +00:00
## Why A connected account or app can choose an approval reviewer, but that setting applies across its tools. Users may want to review calendar event creation themselves while keeping automatic review for other tools. ## What changed Set `approvals_reviewer` on an individual app tool in `config.toml`: ```toml [apps.calendar.tools.calendar_create_event] approvals_reviewer = "user" ``` Codex matches the tool by raw name first and falls back to its title. The tool's reviewer takes precedence over the connected account, app, app defaults, and session settings, subject to managed requirements. This applies to tool-call approval prompts and MCP approval requests that match a verified app tool invocation. The app-server `config/read` response also exposes the per-tool setting. ## Testing Extend coverage for reviewer precedence, tool title fallback, managed review requirements, tool-call approval routing, strict MCP elicitation, and app-server config reads. GitOrigin-RevId: c92bd39b9e708dada9d314c19a446b4c580edf91
OpenAI Codex Python SDK
Build Python applications that start Codex threads, run turns, stream progress, and control workspace access.
Install
Install the SDK:
pip install openai-codex
Quickstart
The SDK reuses your existing Codex authentication when one is already available:
from openai_codex import Codex
with Codex() as codex:
thread = codex.thread_start()
result = thread.run("Explain this repository in three bullets.")
print(result.final_response)
thread.run(...) returns a TurnResult containing the final response,
collected items, and token usage.
Authentication
Existing Codex authentication is reused automatically. To start ChatGPT browser login explicitly:
from openai_codex import Codex
with Codex() as codex:
login = codex.login_chatgpt()
print(login.auth_url)
print(login.wait().success)
For device-code login:
with Codex() as codex:
login = codex.login_chatgpt_device_code()
print(login.verification_url, login.user_code)
login.wait()
For API-key login:
with Codex() as codex:
codex.login_api_key("sk-...")
Built-In Help
Use Python's standard help(openai_codex), help(Codex), or
python -m pydoc openai_codex documentation tools.
Documentation
The package is licensed under the repository Apache License 2.0.