### Migration Checklist - Install Official Codex CLI Source: https://github.com/ndycode/codex-multi-auth/blob/main/docs/upgrade.md Install the official Codex CLI using npm. ```bash npm i -g @openai/codex ``` -------------------------------- ### Day-1 Command Pack Source: https://github.com/ndycode/codex-multi-auth/blob/main/docs/getting-started.md A set of essential commands for initial setup and verification. ```bash codex-multi-auth status codex-multi-auth list codex-multi-auth switch 2 codex-multi-auth check codex-multi-auth forecast --live ``` -------------------------------- ### Quick Start Usage Examples Source: https://github.com/ndycode/codex-multi-auth/blob/main/README.md Provides commands for daily use after installation and verification. ```bash codex-multi-auth list codex-multi-auth switch 2 codex-multi-auth forecast --live ``` -------------------------------- ### Verify codex-multi-auth installation Source: https://github.com/ndycode/codex-multi-auth/blob/main/docs/getting-started.md Command to check if 'codex-multi-auth' is recognized in the system's PATH. ```bash where codex-multi-auth ``` -------------------------------- ### Local Setup Commands Source: https://github.com/ndycode/codex-multi-auth/blob/main/CONTRIBUTING.md Commands to set up the local development environment, including installing dependencies, type checking, linting, testing, and building. ```bash npm ci npm run typecheck npm run lint npm test npm run build ``` -------------------------------- ### Quick Start Installation (Existing Native CLI) Source: https://github.com/ndycode/codex-multi-auth/blob/main/README.md Installs the multi-auth package and logs in if the official native CLI is already installed. ```bash npm i -g codex-multi-auth codex-multi-auth login ``` -------------------------------- ### Install codex-multi-auth Source: https://github.com/ndycode/codex-multi-auth/blob/main/skills/codex-auth-setup/SKILL.md Install or reinstall the codex-multi-auth package. ```bash npm i -g @openai/codex npm i -g codex-multi-auth ``` -------------------------------- ### Quick Start Installation and Sign-in Source: https://github.com/ndycode/codex-multi-auth/blob/main/README.md Installs the official native CLI and the multi-auth package, then logs in. ```bash npm i -g @openai/codex npm i -g codex-multi-auth codex-multi-auth login ``` -------------------------------- ### Quick Start Source: https://github.com/ndycode/codex-multi-auth/blob/main/docs/benchmarks/code-edit-format-benchmark.md Commands to run the edit format benchmark. ```bash npm run bench:edit-formats ``` ```bash npm run bench:edit-formats:smoke ``` ```bash npm run bench:edit-formats:render ``` -------------------------------- ### Core Commands Source: https://github.com/ndycode/codex-multi-auth/blob/main/docs/development/TESTING.md Core commands for testing, linting, building, and running tests. ```bash npm run typecheck npm run lint npm run test npm run build ``` -------------------------------- ### Runtime command usage examples Source: https://github.com/ndycode/codex-multi-auth/blob/main/docs/development/IA_FINDABILITY_AUDIT_2026-03-01.md Examples of runtime command usage strings, showing canonical and package-prefixed forms. ```text codex-multi-auth auth fix [--dry-run] [--json] [--live] [--model ] ``` ```text codex-multi-auth auth switch ``` ```text codex-multi-auth fix [--dry-run] [--json] [--live] [--model ] ``` ```text Missing index. Usage: codex-multi-auth switch ``` -------------------------------- ### Step-by-step Installation for LLM Agents Source: https://github.com/ndycode/codex-multi-auth/blob/main/README.md Provides a step-by-step guide for installing and setting up the package for LLM agents. ```bash npm i -g codex-multi-auth codex-multi-auth login codex-multi-auth status codex-multi-auth check codex-multi-auth forecast --live ``` -------------------------------- ### Verify Install and Routing Commands Source: https://github.com/ndycode/codex-multi-auth/blob/main/docs/troubleshooting.md Commands to check the installation of the CLI and multi-auth package, and their versions. ```bash where codex where codex-multi-auth where codex-multi-auth-codex codex --version codex-multi-auth --version codex-multi-auth-codex --version codex-multi-auth status npm ls -g codex-multi-auth ``` -------------------------------- ### Installed CLI surfaces Source: https://github.com/ndycode/codex-multi-auth/blob/main/docs/architecture.md The package.json publishes these command-line interface entry points. ```bash codex-multi-auth -> scripts/codex-multi-auth.js codex-multi-auth-codex -> scripts/codex.js codex-multi-auth-app-launcher -> scripts/codex-app-launcher.js ``` -------------------------------- ### Disable runtime rotation Source: https://github.com/ndycode/codex-multi-auth/blob/main/docs/getting-started.md Turn off runtime rotation and restore the packaged app bind if one was installed. ```bash codex-multi-auth rotation disable ``` -------------------------------- ### Git Blame Command Example Source: https://github.com/ndycode/codex-multi-auth/blob/main/docs/audits/evidence/git-forensics.txt Example of using `git blame --line-porcelain` to get line-by-line blame information. ```bash git blame --line-porcelain ``` -------------------------------- ### Verify new account Source: https://github.com/ndycode/codex-multi-auth/blob/main/docs/getting-started.md After logging in, verify that the new account is recognized and listed. ```bash codex-multi-auth status codex-multi-auth list codex-multi-auth check ``` -------------------------------- ### Full Call Shape Example Source: https://github.com/ndycode/codex-multi-auth/blob/main/bench/format-benchmark/prompts/hashline-v2.md Demonstrates the complete structure of a Hashline v2 edit call, including the file path and an array of edit operations. ```json { "path": "src/TodoApp.tsx", "edits": [ { "op": "sub", "tag": "7#abc", "old": "Todos", "new": "Tasks" }, { "op": "ins", "eof": true, "content": ["export default TodoApp;"] } ] } ``` -------------------------------- ### Refresh account state Source: https://github.com/ndycode/codex-multi-auth/blob/main/docs/getting-started.md Commands to diagnose and fix stale account state issues. ```bash codex-multi-auth doctor --fix codex-multi-auth check ``` -------------------------------- ### 60-Second Path Commands Source: https://github.com/ndycode/codex-multi-auth/blob/main/docs/index.md Commands for quick login, listing accounts, and checking status. ```bash codex-multi-auth login codex-multi-auth list codex-multi-auth check ``` -------------------------------- ### Manual or no-browser login Source: https://github.com/ndycode/codex-multi-auth/blob/main/docs/getting-started.md Alternative login methods for when the normal browser-first flow is unavailable. ```bash codex-multi-auth login --manual CODEX_AUTH_NO_BROWSER=1 codex-multi-auth login --manual ``` -------------------------------- ### Manual callback with redirect URL Source: https://github.com/ndycode/codex-multi-auth/blob/main/docs/getting-started.md Provide the full redirect URL on stdin for non-TTY/manual shells. ```bash echo "http://127.0.0.1:1455/auth/callback?code=..." | codex-multi-auth login --manual ``` -------------------------------- ### Optional Plugin-Host Smoke Source: https://github.com/ndycode/codex-multi-auth/blob/main/docs/development/TESTING.md Placeholder for running a custom host runtime smoke command. ```bash ``` -------------------------------- ### Device auth login Source: https://github.com/ndycode/codex-multi-auth/blob/main/docs/getting-started.md Use device-code flow for remote, SSH, container, or other headless shells. ```bash codex-multi-auth login --device-auth ``` -------------------------------- ### Optional Core Commands Source: https://github.com/ndycode/codex-multi-auth/blob/main/docs/development/TESTING.md Optional commands for watching tests, generating coverage reports, and running specific test files. ```bash npm run test:watch npm run test:coverage npm test -- test/documentation.test.ts npm test -- test/runtime-rotation-proxy.test.ts test/codex-bin-wrapper.test.ts npm run test:model-matrix:smoke npm run bench:edit-formats:smoke ``` -------------------------------- ### Troubleshoot OAuth callback failures Source: https://github.com/ndycode/codex-multi-auth/blob/main/docs/getting-started.md Steps to resolve issues with the OAuth callback on a specific port, including stopping the process, rerunning login, and using alternative login methods. ```bash codex-multi-auth login --device-auth ``` ```bash codex-multi-auth login --manual ``` -------------------------------- ### Alternate login paths Source: https://github.com/ndycode/codex-multi-auth/blob/main/skills/codex-auth-setup/SKILL.md Login methods for environments where browser launch is blocked or the shell is headless. ```bash codex-multi-auth login --manual CODEX_AUTH_NO_BROWSER=1 codex-multi-auth login ```