v1.0.0 — Codex engineering setup
The first stable release provides a complete, reusable engineering environment
for OpenAI Codex, from personal defaults to project-specific workflows.
Highlights
- Native configuration: compact global guidance, project templates, and separate build, review, and compute profiles.
- Specialist workflows: 23 native agents and eight skills covering web, Android, iOS, compute, quality checks, onboarding, releases, and documentation.
- Reversible installation: preview changes, preserve existing settings/integrations, back up originals, and restore without overwriting later edits.
- Practical documentation: working examples, installation/rollback, permissions, hooks, troubleshooting, compatibility, security, and contribution guidance.
- Verifiable distribution: versioned tar.gz and zip archives, SHA256SUMS, and automated macOS/Linux validation.
Install
Requires macOS/Linux, Python 3.11+, Git, and a compatible Codex CLI (0.154.0 tested).
Download an archive below and verify it against SHA256SUMS, then extract it:
cd codex-setup-v1.0.0
python3 scripts/install.py
python3 scripts/install.py --applyTo add the optional advisory hook, pass --hooks, restart Codex, and review/trust
its exact definition in /hooks. Existing MCP connections, authentication,
plugins, and custom settings are preserved. No model or reasoning level is pinned.
Scope and verification
Automated checks cover installer/restore behavior, documented hook events, and
release packaging integrity. Native startup and instruction/skill discovery were
checked with Codex 0.154.0 on macOS. CI runs Python 3.11 and 3.14 on macOS/Linux.
The optional hook is advisory, not a secret scanner or mandatory commit gate.
Windows, hosted-cloud setup, third-party integrations, and target-device/GPU
behavior are not validated by this package. Custom asset conflicts require a
deliberate merge. See the included compatibility and security documentation.
Release contents
codex-setup-v1.0.0.tar.gzcodex-setup-v1.0.0.zipSHA256SUMS
Both archives contain the complete committed project under one versioned directory.
Changelog