ACE - Handbook Integration Codex 

Codex CLI provider integration for ACE handbook skills and workflows.
ACE Logo 

<a href="https://rubygems.org/gems/ace-handbook-integration-codex"><img alt="Gem Version" src="https://img.shields.io/gem/v/ace-handbook-integration-codex.svg" /></a>
<a href="https://www.ruby-lang.org"><img alt="Ruby" src="https://img.shields.io/badge/Ruby-3.2+-CC342D?logo=ruby" /></a>
<a href="https://opensource.org/licenses/MIT"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-blue.svg" /></a>

Works with: Claude Code, Codex CLI, OpenCode, Gemini CLI, pi-agent, and more.

ace-handbook ace-handbook-integration-codex maps canonical ACE handbook skills into Codex-native projection assets when you explicitly run ace-handbook sync --provider codex, while keeping semantics unchanged from the definitions in ace-handbook. Plain ace-handbook sync uses the neutral .agents/skills/ projection.

Use Cases

Run handbook workflows in Codex-native contexts - keep the same behavior while using Codex-native execution entrypoints when a project explicitly needs .codex/skills/.

Avoid duplication across providers - update canonical skill definitions once in ace-handbook and generate Codex-specific projections automatically from shared contracts.

Keep integration delivery minimal - maintain a focused provider shim layer with only the manifests and projection assets needed for Codex compatibility.

Testing

This package is fast-only in the ACE testing model.

  • Deterministic test coverage lives under test/fast/.
  • This migration does not introduce test/feat/ or test/e2e/ for this package.

Verification commands:

  • ace-test ace-handbook-integration-codex
  • ace-test ace-handbook-integration-codex all

Part of ACE