codex.md

Codex Adapter

Codex does not use Claude Code slash commands or Claude plugins.

Use PACT through:

AGENTS.md
.pact/

AGENTS.md tells Codex how to follow the PACT workflow. .pact/ contains the state file, templates, scripts, and checks.

AGENTS.md is the portable agent entry. It should stay short, point to .pact/core/workflow.md, and use phase decisions plus Don't/Do guidance instead of long warning lists.

Install

Recommended:

curl -fsSL https://raw.githubusercontent.com/Hypho/pact/main/scripts/install-from-github.sh | bash -s -- --target your-project --mode codex

Direct GitHub installation is the primary path because it writes PACT files into the target project.

From the PACT repository root, copy these into your project root:

AGENTS.md
.pact/

Example:

cp -r AGENTS.md .pact your-project/

Optional but useful for documentation parity:

USAGE.md
USAGE.zh.md
README.md

Use

Codex does not read .claude/commands as slash commands. Use natural-language requests that map to the canonical workflow in .pact/core/workflow.md.

For the maintained prompt set, see prompts.md.

For modules with strong local conventions, create a local AGENTS.md from .pact/templates/module-AGENTS.md.

Checks

Run:

bash .pact/bin/pact.sh check --project

Agent entry lint:

bash .pact/bin/pact.sh lint-agents --all

If the project adopts PACT's release layer with VERSION and CHANGELOG.md:

bash .pact/bin/pact-release-check.sh

Limitations

Codex will not automatically expose /pact.* commands from .claude/commands. Treat those files as Claude Code-specific command definitions.