specrails-core 2.1.1 → 2.1.2

package/README.md

@@ -5,6 +5,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![npm downloads](https://img.shields.io/npm/dw/specrails-core.svg)](https://www.npmjs.com/package/specrails-core)
 [![Claude Code](https://img.shields.io/badge/Built%20for-Claude%20Code-blueviolet)](https://docs.anthropic.com/en/docs/claude-code)
+[![Codex](https://img.shields.io/badge/Built%20for-OpenAI%20Codex-412991)](https://github.com/openai/codex)
 
 **Your AI development team. From idea to production code.**
 
@@ -14,7 +15,7 @@ One command gives your repo a full team of specialized AI agents: architect, dev
 npx specrails-core@latest init --root-dir .
 ```
 
-> **Requirements:** [Claude Code](https://docs.anthropic.com/en/docs/claude-code) (required), Node 18+, git
+> **Requirements:** [Claude Code](https://docs.anthropic.com/en/docs/claude-code) or [Codex CLI](https://github.com/openai/codex) (choose one), Node 18+, git
 
 <!--
   BOARD: Add demo GIF here — this is the #1 conversion driver on Product Hunt and npm.
@@ -51,10 +52,12 @@ Every artifact (agents, rules, personas) is generated **specifically for your pr
 npx specrails-core@latest init --root-dir .
 ```
 
-**2. Run setup inside Claude Code**
+**2. Run setup inside your AI CLI**
 
 ```bash
-claude      # open Claude Code in your project
+claude      # Claude Code
+# or
+codex       # OpenAI Codex (beta)
 > /setup    # run the 5-phase wizard (~5 min)
 ```
 

package/docs/testing/test-matrix-codex.md

@@ -37,15 +37,15 @@ Epic: [SPEA-505](/SPEA/issues/SPEA-505) — Codex Compatibility Approach B
 | Feature | Claude Code | Codex |
 |---------|:-:|:-:|
 | Legacy slash commands `.claude/commands/sr/` | ✅ | ❌ |
-| SKILL.md format `.claude/skills/sr-*/` | 🔄 | 🔄 |
-| `sr:implement` skill | ✅ | 🔄 |
-| `sr:product-backlog` skill | ✅ | 🔄 |
-| `sr:health-check` skill | ✅ | 🔄 |
-| `sr:compat-check` skill | ✅ | 🔄 |
-| `sr:why` skill | ✅ | 🔄 |
-| `sr:refactor-recommender` skill | ✅ | 🔄 |
-| `sr:batch-implement` skill | ✅ | 🔄 |
-| `sr:update-product-driven-backlog` skill | ✅ | 🔄 |
+| SKILL.md format `.claude/skills/sr-*/` | ✅ | ✅ |
+| `sr:implement` skill | ✅ | ✅ |
+| `sr:product-backlog` skill | ✅ | ✅ |
+| `sr:health-check` skill | ✅ | ✅ |
+| `sr:compat-check` skill | ✅ | ✅ |
+| `sr:why` skill | ✅ | ✅ |
+| `sr:refactor-recommender` skill | ✅ | ✅ |
+| `sr:batch-implement` skill | ✅ | ✅ |
+| `sr:update-product-driven-backlog` skill | ✅ | ✅ |
 | Backward compat: slash commands still invoke correctly | ✅ | — |
 
 ### Permissions Configuration (SPEA-508)
@@ -76,12 +76,12 @@ Epic: [SPEA-505](/SPEA/issues/SPEA-505) — Codex Compatibility Approach B
 
 | Feature | Claude Code | Codex |
 |---------|:-:|:-:|
-| Hub detects claude binary | 🔄 | — |
-| Hub detects codex binary | — | 🔄 |
-| `integration-contract.json` v2 schema valid | 🔄 | 🔄 |
-| Hub invokes CLI with correct args | 🔄 | 🔄 |
-| Hub dashboard shows CLI badge | 🔄 | 🔄 |
-| Hub handles "no CLI detected" state | 🔄 | 🔄 |
+| Hub detects claude binary | ✅ | — |
+| Hub detects codex binary | — | ✅ |
+| `integration-contract.json` v2 schema valid | ✅ | ✅ |
+| Hub invokes CLI with correct args | ✅ | ✅ |
+| Hub dashboard shows CLI badge | ✅ | ✅ |
+| Hub handles "no CLI detected" state | ✅ | ✅ |
 
 ---
 

package/docs/user-docs/cli-reference.md

@@ -410,6 +410,7 @@ The `npx specrails-core@latest init` command accepts:
 |------|--------|
 | `--root-dir <path>` | Install into this directory (default: current directory) |
 | `--yes` / `-y` | Skip confirmation prompts |
+| `--provider <claude\|codex>` | Force a specific AI CLI (default: auto-detect) |
 
 ---
 

package/docs/user-docs/getting-started-codex.md

@@ -177,7 +177,7 @@ codex --version
 If Codex is installed via a custom path, pass the provider explicitly:
 
 ```bash
-CLI_PROVIDER=codex npx specrails-core@latest init --root-dir .
+npx specrails-core@latest init --root-dir . --provider codex
 ```
 
 ### Existing `.codex/` directory detected

package/docs/user-docs/installation.md

@@ -13,7 +13,7 @@ SpecRails supports both **Claude Code** and **OpenAI Codex**. The installer dete
 | **Codex CLI** | Latest | Beta — `npm i -g @openai/codex` |
 | **Git** | Any | Your project must be a git repository |
 
-You need at least one of Claude Code or Codex CLI. If both are installed, the installer uses Claude Code by default. Override with `CLI_PROVIDER=codex`.
+You need at least one of Claude Code or Codex CLI. If both are installed, the installer uses Claude Code by default. Override with `--provider codex` (or the env var `CLI_PROVIDER=codex`).
 
 Optional but recommended:
 
@@ -38,9 +38,16 @@ The installer copies agent templates, skills, and configuration files into `.cla
 |------|--------|
 | `--root-dir <path>` | Target directory (default: current directory) |
 | `--yes` / `-y` | Skip confirmation prompts |
+| `--provider <claude\|codex>` | Force a specific AI CLI (default: auto-detect) |
 
 You can also force a specific provider:
 
+```bash
+npx specrails-core@latest init --root-dir . --provider codex
+```
+
+Alternatively, use the `CLI_PROVIDER` env var (legacy):
+
 ```bash
 CLI_PROVIDER=codex npx specrails-core@latest init --root-dir .
 ```
@@ -169,7 +176,7 @@ npm i -g @openai/codex
 Or force the provider if Codex is installed at a non-standard path:
 
 ```bash
-CLI_PROVIDER=codex npx specrails-core@latest init --root-dir .
+npx specrails-core@latest init --root-dir . --provider codex
 ```
 
 ---

package/docs/user-docs/quick-start.md

@@ -2,6 +2,8 @@
 
 Get SpecRails running in your project in under 10 minutes.
 
+> **Using OpenAI Codex?** See the [Codex getting started guide](getting-started-codex.md) — setup is slightly different.
+
 ## Before you begin
 
 You need:

package/install.sh

@@ -290,15 +290,24 @@ if [[ "$CLI_PROVIDER" == "claude" ]]; then
     fi
 else
     # Codex
+    CODEX_AUTHED=false
     if [[ -n "${OPENAI_API_KEY:-}" ]]; then
-        ok "OpenAI API key: configured"
+        CODEX_AUTHED=true
+    elif codex login status 2>/dev/null | grep -qi "logged in"; then
+        CODEX_AUTHED=true
+    elif [[ -f "${HOME}/.codex/auth.json" ]] && grep -q '"access_token"' "${HOME}/.codex/auth.json" 2>/dev/null; then
+        CODEX_AUTHED=true
+    fi
+
+    if [[ "$CODEX_AUTHED" == "true" ]]; then
+        ok "Codex: authenticated"
     elif [[ "$SKIP_PREREQS" == "1" ]]; then
-        warn "No OpenAI API key configured (skipped — SPECRAILS_SKIP_PREREQS=1)"
+        warn "Codex authentication not found (skipped — SPECRAILS_SKIP_PREREQS=1)"
     else
-        fail "No OpenAI API key configured."
+        fail "No Codex authentication found."
         echo ""
-        echo "    Set it:  export OPENAI_API_KEY=<your-key>"
-        echo "    Get one: https://platform.openai.com/api-keys"
+        echo "    Option 1 (API key): export OPENAI_API_KEY=<your-key>"
+        echo "    Option 2 (OAuth):   codex login"
         exit 1
     fi
 fi

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specrails-core",
-  "version": "2.1.1",
+  "version": "2.1.2",
   "description": "AI agent workflow system for Claude Code — installs 12 specialized agents, orchestration commands, and persona-driven product discovery into any repository",
   "bin": {
     "specrails-core": "bin/specrails-core.js"