Guide Codex auth and optional gateway setup in setup skill

[chubes4]

Goal

Update the wp-coding-agents-setup skill so it can guide an operator through Codex auth and optional WP AI Gateway setup without putting provider-specific behavior into the gateway.

Boundary

• ai-provider-for-openai owns Codex OAuth/token handling.
• wp-ai-gateway remains a generic OpenAI-compatible gateway.
• wp-coding-agents owns product wiring for OpenCode/Kimaki external clients.
• The setup skill owns the human/operator recipe.

Scope

• Detect whether wp-ai-gateway is installed and active.
• Detect whether the Codex-capable provider stack is installed/active.
• Detect whether provider codex is available/authenticated when provider CLI/admin status exists.
• Guide the operator through provider auth when the provider exposes a login/status flow.
• Configure wp-ai-gateway only when the operator wants external OpenCode/Kimaki to use WordPress as the OpenAI-compatible endpoint.
• Make clear that Codebox minion fan-out does not require wp-ai-gateway; it uses Codebox connector inheritance/provider auth directly.
• Verify gateway setup with wp ai-gateway status, /models, and a minimal chat completion when gateway mode is selected.

Acceptance criteria

• Setup skill documentation/instructions distinguish two paths:
  • Codebox minions: WordPress AI Client/provider auth inside sandbox, no gateway required.
  • External OpenCode/Kimaki: optional WP AI Gateway endpoint.
• The skill references canonical Automattic/wp-ai-gateway.
• The skill points Codex auth work to Add ChatGPT Codex provider WordPress/ai-provider-for-openai#28 and Add bearer token request authentication WordPress/php-ai-client#238 rather than trying to implement provider auth itself.
• The skill includes a troubleshooting checklist for missing provider, missing model, missing auth, and gateway token failures.

Related

• Optionally install and configure WP AI Gateway for OpenCode runtimes #173
• Prove Codex auth through WP Codebox agent fan-out homeboy-extensions#979
• Add ChatGPT Codex provider WordPress/ai-provider-for-openai#28
• Add bearer token request authentication WordPress/php-ai-client#238
• Automattic/wp-ai-gateway

[chubes4]

Worker thread launched for this scope: https://discord.com/channels/1493321868415996064/1510835963251920896

[chubes4]

Cooked in PR #176: #176

Evidence:

• Updated skills/wp-coding-agents-setup/SKILL.md to distinguish Codebox minions from optional external OpenCode/Kimaki WP AI Gateway setup.
• Clarified that Codebox minions do not require WP AI Gateway and inherit provider auth/Codebox connector state directly.
• Referenced the canonical gateway repo and upstream Codex auth/client issues instead of adding provider-specific behavior here.

Checks run:

• for f in **/*.sh; do bash -n \"\" || exit 1; done
• ./tests/bridge-render.sh
• ./tests/opencode-wrapper-removal.sh
• ./tests/kimaki-agent-fallback.sh
• git diff --check