remodex-cli

remodex-cli is the desktop bridge for Remodex. It connects the Remodex mobile app to the local Codex runtime on your computer.

After installing the package, the command you run is still:

remodex up

Install

npm install -g remodex-cli

Then start the bridge:

remodex up

The published package includes the official Remodex relay by default:

wss://api.phodex.app/relay

That means normal users do not need to set REMODEX_RELAY manually.

Pair Your Phone

1. Install the Remodex mobile app.
2. Run remodex up on your computer.
3. Scan the QR code from inside the Remodex app.
4. Keep the bridge running while using the phone as your Codex remote.

The QR code is only for pairing. After a successful pairing, the app can reconnect to the trusted bridge while it is running.

macOS And Linux

On macOS and Linux, remodex up uses the built-in background service helper.

Useful commands:

remodex up
remodex status
remodex restart
remodex stop
remodex reset-pairing

Windows

On Windows, the bridge currently runs in the foreground. Keep the terminal open while using Remodex.

remodex up

If Windows Firewall asks for permission, allow Node.js on your current network.

Use Your Own Relay

You can override the official relay:

REMODEX_RELAY="wss://your-relay.example/relay" remodex up

On Windows PowerShell:

$env:REMODEX_RELAY="wss://your-relay.example/relay"
remodex up

For local testing from the source repo, use the local launcher in the repository root instead of the npm package.

Requirements

• Node.js 18 or newer
• npm
• Codex CLI or Codex app-server access
• Remodex mobile app

The package can try to install or update the Codex CLI during install. To skip that helper, set:

REMODEX_SKIP_CODEX_BOOTSTRAP=1

Troubleshooting

If remodex up says no relay is configured, update to the latest package:

npm install -g remodex-cli@latest

If pairing fails:

• make sure the bridge is still running
• scan the QR from inside the Remodex app
• check that your computer can reach the relay URL
• run remodex reset-pairing and pair again

If the command is not found after install, make sure your global npm bin folder is in your PATH.

Security

Remodex keeps Codex execution local to your computer. The relay is a transport layer. After secure pairing, app payloads are encrypted between the mobile app and the bridge.

License

ISC