Woz Login Flow
If the user passed --token <token> as arguments, skip directly to the Token Login section below.
Browser Login (Preferred)
First try the installed WOZCODE login command. This opens a browser for the user to log in:
node "${CODEX_HOME:-$HOME/.codex}/plugins/wozcode/scripts/wozcode-cli-codex.js" login
If the command exits with code 0, login succeeded — confirm to the user.
If Codex blocks the browser launch or the command fails before the browser opens, ask the user to run this command in their regular terminal outside Codex:
npx @wozcode/codex login
Tell the user to return after the command prints that authentication succeeded.
Token Login
Use this when:
- The user passed
--token <token>as arguments to this skill - The browser login above timed out or failed and the user provides a token
Once you have the token (from args or from the user), run:
node "${CODEX_HOME:-$HOME/.codex}/plugins/wozcode/scripts/wozcode-cli-codex.js" login --token '<token>'
If Codex blocks the installed command from running, ask the user to run this in their regular terminal outside Codex:
npx @wozcode/codex login --token '<token>'
Replace <token> with the actual token. The npm command still requires WOZCODE for Codex to be installed first.
Confirm success or relay any error to the user.