new-path-codex

new-path-codex signs you in to the New Path GPT proxy, configures the OpenAI Codex CLI, and launches Codex with the proxy token in your local environment.

The default backend is:

https://vibe-coding-path-new-center.rockiestar-com.workers.dev

Requirements

• Node.js 18 or newer.
• The OpenAI Codex CLI installed and available as codex.
• An email address allowlisted by the New Path proxy admin.

Quick Start

npx new-path-codex auth
npx new-path-codex configure
npx new-path-codex

auth sends a one-time code to your allowlisted email and stores a local token. configure adds a Codex profile that points at the New Path proxy. Running new-path-codex launches codex --profile new-path-profile with the token set as NEW_PATH_CODEX_TOKEN.

You can also install it globally:

npm install -g new-path-codex
new-path-codex auth
new-path-codex configure
new-path-codex

Sign In

npx new-path-codex auth

The CLI asks for your email address. If your email is allowlisted, it sends an OTP code. Enter the OTP to store a local user token at:

~/.new-path-codex/token.json

To use a non-default backend:

npx new-path-codex auth --backend https://your-worker.example.com

Configure Codex

npx new-path-codex configure

This updates ~/.codex/config.toml with:

• profile: new-path-profile
• provider: new-path-proxy
• default model: gpt-5.5
• auth env var: NEW_PATH_CODEX_TOKEN

The command writes a timestamped backup before editing your Codex config.

Make It The Default Codex Profile

npx new-path-codex profile-default on

Restore the previous default:

npx new-path-codex profile-default off

Run Codex

npx new-path-codex run

Pass normal Codex arguments after --:

npx new-path-codex run -- -m gpt-5.4-mini
npx new-path-codex run -- --cd /path/to/project
npx new-path-codex run -- --ask-for-approval never

Running without a subcommand also launches Codex:

npx new-path-codex -- -m gpt-5.5

Models

Supported models:

• gpt-5.5
• gpt-5.4-mini

Commands

new-path-codex auth [--backend <url>]
new-path-codex configure [--backend <url>]
new-path-codex profile-default <on|off>
new-path-codex run -- [codex args...]
new-path-codex --version
new-path-codex --help

Local Files

~/.new-path-codex/token.json
~/.new-path-codex/state.json
~/.codex/config.toml

The token file is written with user-only permissions where the platform supports it. Codex config edits are backed up before writing.

Troubleshooting

If auth says your email is not allowed, ask the workspace admin to add your email to the proxy allowlist.

If Codex cannot authenticate, rerun:

npx new-path-codex auth
npx new-path-codex configure

If you want to stop using the profile as your Codex default:

npx new-path-codex profile-default off