skills.rest
em411
em411COMMUNITY
Explore all skills by this author →
GitHub

setup

Diagnoses Codex CLI installation, authentication, and GPT-5.6 model availability for supercodex.

Updated Jul 15, 2026
Search Tags:#authentication#troubleshooting#setup#health check#diagnostics#codex cli#gpt-5.6
One-click install
npx skills add https://github.com/em411/supercodex --skill setup-em411
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: setup
Source: https://github.com/em411/supercodex/tree/main/skills/setup
Command: npx skills add https://github.com/em411/supercodex --skill setup-em411

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When supercodex delegations fail, users cannot tell whether the cause is a missing Codex CLI, an outdated version, a broken login, or unavailable GPT-5.6 models. This Skill runs a structured health check and reports exactly which component is broken and how to fix it. ## Core Features & Use Cases - Environment health check: Runs the codex-companion script in setup mode and interprets JSON fields covering Node.js availability, Codex CLI installation, CLI version versus the GPT-5.6 minimum, and login status. - Live model probe: Dispatches a real GPT-5.6 task expecting a PONG response to confirm end-to-end delegation works, catching model-rejection errors that version checks miss. - Actionable reporting: Summarizes component status in a table with tailored fix commands, and declares one of three outcomes: fully ready, fallback mode on Claude subagents, or running on a non-GPT-5.6 default model. - Use Case: After installing supercodex, ask Claude to run the setup check; it reports that your Codex CLI is below the minimum version and gives you the exact npm upgrade command. ## Quick Start Ask Claude to run the supercodex setup check to verify the Codex CLI, authentication, and GPT-5.6 model availability on this machine.

Frequently Asked Questions about setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify my Codex CLI setup for supercodex?▼

Run the setup skill, which executes the codex-companion script in setup mode and checks Node.js, Codex CLI installation, CLI version, and login status. It reports each component's health with the exact fix command for anything broken.

How do I check if GPT-5.6 models work with my Codex CLI?▼

The setup check compares your installed CLI version against the minimum required for GPT-5.6 and then runs a live probe task expecting a PONG response. A successful PONG confirms end-to-end GPT-5.6 delegation works.

What Codex CLI version is required for GPT-5.6 models?▼

Codex CLI version 0.144.4 or later is required, as earlier versions reject the GPT-5.6 tiering models. Upgrade with npm install -g @openai/codex@latest if the check reports supportsGpt56 as false.

What happens if Codex is unavailable when running supercodex?▼

Supercodex runs in fallback mode: workflows still function, but implementation tasks execute on Claude subagents instead of Codex until the reported fixes are applied. The setup report states this explicitly.

Why does the setup check fail even after codex login?▼

Login alone is not sufficient; the check also requires Node.js 20 or later and a CLI version supporting GPT-5.6. If the browser login flow is blocked, use codex login --device-auth, then re-run the check.

Related Skills

Explore More Software Engineering Skills→
samlaggzsamlaggz

codex

Delegate coding tasks to Codex CLI within Hermes workflows.

Community
Advanced
sukbearaisukbearai
4

codex-luna

Delegates frozen implementation plans to a GPT-5.6 Luna executor via Codex CLI.

Community
Advanced
sukbearaisukbearai
4

codex-first

Delegates scoped implementation and bug-fix tasks to Codex CLI while Claude retains review.

Community
Intermediate
hanamizukihanamizuki
127

second-opinion

Review plans, specs, and design docs with an adversarial perspective.

Community
Advanced