v1.1.0 — Codex engineering setup

v1.1.0 — Repository exploration utility

This release adds repo-explorer, a native read-only utility for bounded repository
lookups. It searches in its own context and returns a concise answer with file:line
evidence and coverage gaps, keeping broad file reads out of the main conversation.

Changes

• 24 native agents: the existing 23 specialist roles plus repo-explorer.
• Scoped delegation: global guidance delegates broad independent lookups when
  useful local work can proceed alongside them. Simple lookups stay local; requests
  not to delegate and higher-priority restrictions take precedence.
• Role-specific model choice: the utility uses gpt-5.6-terra with low reasoning.
  All 23 specialist roles retain the caller's model and effort. If the utility or
  its model is unavailable, the main agent continues the lookup locally.
• Inspection-only scope: the utility reports evidence without editing files,
  executing project scripts/tests/builds, inspecting credentials, or mutating
  external services. It returns design and correctness decisions to the caller.
• Complete documentation: README, agent inventory, exploration workflow, model
  customization, installation, verification, and official sources are updated.

The custom name leaves Codex's built-in explorer unchanged. Read-only permissions
remain subject to live runtime overrides. Subagents add token overhead; using a
lighter worker does not guarantee a cheaper overall task.

Install or upgrade

Requires macOS/Linux, Python 3.11+, Git, and Codex CLI 0.154.0 or newer.
Verify a downloaded archive against SHA256SUMS, extract it, then run:

cd codex-setup-v1.1.0
python3 scripts/install.py
python3 scripts/install.py --apply

For an unchanged v1.0.1 installation, the preview contains two changes: the new
agent file under Codex home and the managed global guidance block. Existing skills,
specialist agents, main model settings, and hook definitions are unchanged.
Customized assets retain normal conflict protection. See
installation and upgrades
for older versions and restoration.

Start a fresh codex session in your project after installation. No profile or new
hook is required. Model availability depends on the account and client; persistent
model customization is described in
repository exploration.

Verification and limits

All 18 installer, hook, and release-packaging tests pass locally, together with
structural validation of 30 TOML files, eight skills, and documentation links.
CodeRabbit reviewed the explorer implementation and documentation with zero findings.
Native strict-config startup, model-catalog lookup, and global instruction discovery
were checked. A live explorer task was not run; configuration checks do not establish
model behavior. Release CI runs macOS/Linux with Python 3.11 and 3.14 before publishing.

Assets

• codex-setup-v1.1.0.tar.gz
• codex-setup-v1.1.0.zip
• SHA256SUMS

Full changes

v1.0.1 — Codex engineering setup

v1.0.1 — Automatic project onboarding

Start Codex in your project and describe the coding task. The global setup now
instructs Codex to create project guidance when it is missing and continue directly
into the requested work. No separate onboarding prompt or profile is required.

Changes

• Global instructions select the onboarding skill for implementation tasks in
  bounded repositories or explicitly designated project directories without guidance.
• The skill creates a concise root AGENTS.md from repository evidence, reads it,
  and continues the task. It preserves existing project guidance and skips read-only
  questions/reviews, explicit opt-outs, and destinations where writes are restricted.
• The skill ignores embedded directives in inspected repository content and checks
  generated guidance before applying it. An adversarial fixture supplies manual
  evaluation inputs and failure criteria without claiming guaranteed isolation.
• README and project documentation use plain codex and explain optional profiles,
  project trust, empty-project requests, and the limits of instruction-driven setup.
• Release documentation describes PR review, checks, merging, and tagging the merged commit.

This is a model-guided workflow, not a startup hook or an enforced guarantee.
Project trust and permission prompts still apply. The update does not change models,
permission defaults, agent roles, or hook definitions.

Install or upgrade

Requires macOS/Linux, Python 3.11+, Git, and Codex CLI 0.154.0 or newer.
Verify the downloaded archive against SHA256SUMS, extract it, then run:

cd codex-setup-v1.0.1
python3 scripts/install.py
python3 scripts/install.py --apply

Existing v1.0.0 installs: the changed onboarding skill triggers the installer's
asset-conflict protection, even if you have not customized it. Restore previous
installation manifests newest-first when their hashes still match, then install
v1.0.1. Otherwise back up and deliberately reconcile the changed files as described
in upgrade instructions.
The installer never overwrites customized skills or bypasses restoration checks.

Use --hooks if installing the optional advisory hook. Start a fresh Codex session
after upgrading global instructions. From your project directory, run codex and
describe your task; for an empty project, include the product and intended stack.
Say "skip project setup" to opt out of automatic onboarding.

Verification

The local validation suite passes all 18 tests covering installation/restoration,
hook behavior, and release packaging; structural and skill validation also pass.
Native Codex prompt inspection confirms discovery of the new global instructions
and onboarding skill description. Discovery validation does not establish model
compliance in every task. Release CI runs the suite on macOS/Linux with Python
3.11 and 3.14 before publishing the version-matched archives and checksums.

Assets

• codex-setup-v1.0.1.tar.gz
• codex-setup-v1.0.1.zip
• SHA256SUMS

Full changes

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