codex-sdk
Installation
SKILL.md
Codex SDK + Codex CLI (master skill)
Build reliable, auditable, multi-step coding workflows that scale from a single run to multi-agent orchestration.
ExecPlans (durable planning)
For multi-hour work, keep intent durable across compaction/restarts using an ExecPlan:
- Contract:
references/execplans.md - Template + rules:
.agent/PLANS.md(usescripts/init_agent_workspace.pyto bootstrap a repo) - ExecPlan skeleton:
assets/templates/execplan.md(or generate a file withscripts/new_execplan.py)
Workflow decision tree
- Need a scriptable one-shot in CI or cron? → use
codex exec(references/codex-cli-exec.md) - Need a server-side app controlling Codex programmatically? → use
@openai/codex-sdk(references/codex-sdk-typescript.md) - Need multi-agent orchestration or dynamic tools? → run
codex mcp-serverand orchestrate via OpenAI Agents SDK (references/mcp-and-agents-sdk.md) - Need durability across runs (memory, caching, resumable state)? → persist run metadata and event logs in SQLite (
references/state-memory-sqlite.md)