Codex Ultra Commands

Install adaptive, multi-agent “ultra” workflows for OpenAI Codex with one small npm CLI.

npm install --global codex-ultra-commands
codex-ultra install

Restart Codex, then use:

$ultracode migrate this service to the new authentication API
$ultraplan design a safe database tenancy migration
$ultrareview review this branch for production defects

Included workflows

$ultracode

Runs substantial engineering work through adaptive decomposition, parallel specialist agents, durable checkpoints, implementation, testing, and independent verification.

$ultraplan

Builds a repository-grounded implementation plan using independent investigation, requirements analysis, architectural challenge, and a final readiness gate.

$ultrareview

Runs a high-signal multi-agent review. Candidate defects must be independently reproduced or verified before they are included in the final findings.

Smart model routing

The skills route work by capability, risk, and cost rather than hardcoded model names:

| Work | Preferred routing | | --- | --- | | Repository lookup and triage | Fast exploration agents | | External documentation | Research agents | | Package or SDK decisions | Dependency specialists | | Implementation | Execution agents | | Failing or ambiguous behavior | Debugging agents | | Test design and reproduction | Test specialists | | Architecture and high-impact tradeoffs | Strongest available architectural reasoning | | Final acceptance | Independent reviewers and verifiers |

Codex’s current runtime catalog remains authoritative, so the workflows continue working as available roles and models change. The author and final reviewer remain independent.

Installation targets

Install for the current user:

codex-ultra install

This writes managed skills to $CODEX_HOME/skills, or ~/.codex/skills when CODEX_HOME is not set.

Install for one repository:

codex-ultra install --project
codex-ultra install --project /path/to/repository

Project installation writes to <project>/.codex/skills.

Update and uninstall

npm install --global codex-ultra-commands@latest
codex-ultra update

codex-ultra status
codex-ultra uninstall

The CLI records hashes for every managed file. Update and uninstall refuse to overwrite or remove locally modified files unless you explicitly pass --force.

Preview an operation:

codex-ultra update --dry-run
codex-ultra uninstall --dry-run

Get machine-readable status:

codex-ultra status --json
codex-ultra list --json

Archive workflow artifacts

Ultra workflows can keep durable local artifacts under .codex/ultra. Archive completed work without deleting it:

codex-ultra archive plans my-plan
codex-ultra archive reviews auth-review
codex-ultra archive runs migration-run

Use --root /path/to/repository when the command is run outside the target repository.

Safety and scope

Codex Ultra Commands installs ordinary Codex skills. It does not:

• bypass Codex permissions or safety controls;
• increase the runtime’s available concurrency;
• transmit repository contents to a separate service;
• emulate Anthropic’s proprietary cloud infrastructure.

The workflows use the tools, models, subagents, and limits available in the active Codex runtime.

CLI reference

codex-ultra install [--project [path]] [--force] [--dry-run]
codex-ultra update [--project [path]] [--force] [--dry-run]
codex-ultra uninstall [--project [path]] [--force] [--dry-run]
codex-ultra status [--project [path]] [--json]
codex-ultra list [--json]
codex-ultra archive <plans|reviews|runs> <id> [--root path] [--dry-run]
codex-ultra --version
codex-ultra --help

Development

Requires Node.js 20 or newer.

git clone https://github.com/thalixinc/codex-ultra-commands.git
cd codex-ultra-commands
npm test
npm run check
npm pack --dry-run

See CONTRIBUTING.md for the development and release process.

License

MIT © 2026 Thalix Inc.