codex-cli-sdk is a local SDK that wraps the OpenAI Codex CLI process via stdio. It does not make network connections itself — all network access is managed by the underlying CLI binary.
The SDK handles:
- Process spawning and lifecycle management
- JSONL parsing of CLI output
- Approval callback dispatch
- Sandbox policy enforcement (delegated to the CLI)
| Version | Supported |
|---|---|
| 0.1.x | Yes |
If you discover a security vulnerability, please report it responsibly:
- Preferred: Open a GitHub Security Advisory
- Alternative: Email the maintainers directly (see repository contacts)
Please do not open a public issue for security vulnerabilities.
- Description of the vulnerability
- Steps to reproduce
- Potential impact
- Suggested fix (if any)
- Acknowledgment: Within 48 hours
- Initial assessment: Within 1 week
- Fix and disclosure: Coordinated with reporter
- The SDK spawns child processes — ensure
cli_pathis trusted if set explicitly ApprovalPolicy::Neverauto-approves all agent actions — use only in trusted environmentsSandboxPolicy::DangerFullAccessremoves all filesystem restrictions — use with care- Environment variables passed via
CodexConfig::envare forwarded to the child process - Output schemas are written to temp files — they are cleaned up automatically after each turn