Skip to content

v1.0.0 — Codex engineering setup

Choose a tag to compare

@github-actions github-actions released this 12 Sep 00:15
· 2 commits to main since this release

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 --apply

To 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.gz
  • codex-setup-v1.0.0.zip
  • SHA256SUMS

Both archives contain the complete committed project under one versioned directory.
Changelog