One Prompt. Many Workers.
Rust-native orchestration for Codex.app and codex CLI.

codex-superskills is a runtime layer that turns one instruction into an execution plan with parallel workers, visible progress, and verification.

If you want one default command for most real work, use ultrapilot.

• fewer commands, less mode confusion
• faster completion on multi-file work via parallel workers
• better trust through runtime visibility and completion evidence
• same runtime behavior on Codex.app and codex CLI

HUD/runtime output is standardized with the [Skills] prefix.

npm install -g codex-superskills
superskills setup --target codex
superskills skills sync

superskills codex run "ultrapilot: implement OAuth login and verify tests"

git clone https://github.com/shaun0927/codex-superskills.git
cd codex-superskills
npm install
npm run build

./scripts/superskills-entry.sh setup --target codex
./scripts/superskills-entry.sh skills sync
./scripts/superskills-entry.sh codex run "ultrapilot: analyze and improve this repository"

You should see phase/stage/task visibility while workers run, not a black box.

[Skills] ultrapilot workers_running
[phase] implement
[stage] parallel-execution
[tasks] running=3 queued=1 completed=5

superskills codex bridge-status --json
superskills codex run "ultrapilot: health check" --json
superskills codex run "cancel" --json
superskills hud --once --json

Expected signals:

• bridgeInstalled: true
• mcpBridge.state: "configured"
• runtime policy level: execute

• canonical MCP tools: superskills_dispatch_watch, superskills_keyword_dispatch, superskills_runtime_status
• legacy aliases are preserved for compatibility (omcx_*, OMCX_*)
• team is team-lite semantics (not full legacy Team parity)
• OpenClaw is not in active runtime execution path

After updates:

superskills setup --target codex
superskills skills sync

If MCP bridge is not configured:

codex mcp add t -- "$(pwd)/bridge/run-mcp-server.sh"

Optional macOS menubar lifecycle helper:

superskills codex hud-menubar-agent start
superskills codex hud-menubar-agent status
superskills codex hud-menubar-agent stop

• install and local setup: docs/LOCAL_PLUGIN_INSTALL.md
• full reference: docs/REFERENCE.md
• architecture: docs/ARCHITECTURE.md
• runtime boundaries: docs/RUNTIME-BOUNDARIES.md
• compatibility: docs/COMPATIBILITY.md

npm install
npm run build
npm run test:run
npm run check:codex-branding
npm run check:codex-guard
npm run gate:full

MIT