Connects a locally running OpenAI Codex CLI session to the official ChatGPT mobile app, generating pairing QR codes/links, checking remote relay connectivity, listing and revoking paired devices, and enabling or disabling persistent remote access, so users can view and continue their Codex conversations from ChatGPT on their phone.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Codex Remote Show the QR for remote session pairing."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Connect Codex running on your computer to the official ChatGPT phone app. Generate a pairing QR, check connected devices, and manage remote access from your terminal or by asking Codex.
Use any operating system where Codex provides the required native managed-server remote interface. Linux is verified; macOS, Windows, and other operating systems are currently untested.
Codex Remote is a community plugin by Cheaux. It uses Codex's native remote service and your existing ChatGPT sign-in. OpenAI does not maintain or endorse this plugin.
Step-by-step guide · Downloads · Troubleshooting · Report a problem
Pair your phone by asking Codex: “Show the QR for remote session pairing.”
Continue an existing Codex conversation from ChatGPT on your phone.
Check remote connectivity and see paired devices.
Disable remote access or revoke a specific device when you choose.
The plugin uses the existing Codex daemon. It preserves local conversations and existing pairings, requires no separate API key, and opens no additional network listener.
Related MCP server: Codex MCP Telegram
After installing the plugin, use these commands in your regular terminal.
Command | What it does |
| Show a fresh QR, phone link, manual code, and expiration. Enables access if needed. |
| Check the remote relay and paired devices. |
| Show device names and IDs. |
| Remove the specific device you choose. |
| Turn off remote access while preserving local sessions and pairings. |
| Turn remote access back on. |
| Register |
| Remove |
Remote access stays enabled until you disable it. Uninstalling the plugin does not turn off native remote access. If you want it off, run codex-remote disable first. Disabling access and removing a paired device are separate actions.
pair is an alias for qr. Commands support --json for scripts. Full command reference
You need:
A computer on any OS with Node.js 24 or newer, including npm, and Codex's required native managed-server remote interface. See the testing status below.
Codex CLI installed and signed in with ChatGPT. The tested Codex version is 0.163.0.
The official ChatGPT app on your phone, using the same account and workspace as Codex. Account or workspace policies may restrict remote access.
An internet connection. Your PC must stay awake with Codex's managed server running while you use it remotely.
Check your installed versions in a regular terminal:
node --version
codex --versionThe native remote interface is experimental. Android pairing and existing-chat messaging have been verified. See compatibility for the exact testing status.
Run the commands for your shell in a regular terminal on your computer. The Bash/Zsh commands install into your user account without sudo.
Bash / Zsh (Linux or macOS):
export PATH="$HOME/.local/bin:$PATH"
curl --fail --location --output codex-remote-0.2.1.tgz \
https://github.com/Cheaux/codex-remote/releases/download/v0.2.1/codex-remote-0.2.1.tgz
npm install --global --prefix "$HOME/.local" --ignore-scripts ./codex-remote-0.2.1.tgz
codex-remote install
codex-remote qrPowerShell (Windows, untested):
Invoke-WebRequest -Uri https://github.com/Cheaux/codex-remote/releases/download/v0.2.1/codex-remote-0.2.1.tgz -OutFile codex-remote-0.2.1.tgz
npm install --global --ignore-scripts .\codex-remote-0.2.1.tgz
codex-remote install
codex-remote qrThe PowerShell commands use npm's default global installation directory. Downloading the archive first also works with npm 12's default restriction on direct URL installs. Native Codex must expose the same managed-server remote interface; installation alone does not establish OS compatibility.
codex-remote install registers the plugin with Codex. codex-remote qr enables persistent remote access if needed and displays a short-lived pairing code.
Scan the QR with your phone's camera, or open the printed pairing link on your phone.
Complete the setup in ChatGPT with the same account and workspace.
Run codex-remote status on your PC to check connectivity and paired devices.
Open a new Codex terminal to load the conversational tools. You can leave your current conversations running.
In that new Codex conversation, try:
Show the QR for remote session pairing.
You only need a fresh QR when pairing another device or replacing an expired code. For an existing connection, ask “Check my remote connection” instead.
If a new Bash/Zsh terminal cannot find codex-remote, add export PATH="$HOME/.local/bin:$PATH" to your shell's startup file. For PowerShell, check that npm's global executable directory is on PATH. The installation guide explains both paths.
/qr and autocompleteInstall Codex Command Extensions once for terminal commands. Codex Folders is not required. Remote registers /qr with this shared host; other plugins register their own commands independently.
On Linux/macOS with Python 3:
export PATH="$HOME/.local/bin:$PATH"
curl --fail --location --output codex-terminal-extensions-0.1.2.tgz \
https://github.com/Cheaux/codex-command-extensions/releases/download/v0.1.2/codex-terminal-extensions-0.1.2.tgz
npm install --global --prefix "$HOME/.local" --ignore-scripts ./codex-terminal-extensions-0.1.2.tgz
codex-remote terminal enableOpen a new codex terminal. Type /q, use Tab to complete /qr, and press Enter. Scan the QR, then press Enter to return to your retained chat. Arrows select custom or native commands; Escape dismisses suggestions.
The shared host installs one user-local launcher, preserves the original Codex binary, and keeps active sessions running. Its current PTY backend supports Linux/macOS; Windows terminal integration requires a separate backend. CLI and conversational pairing remain independent of the host.
codex-remote install registers /qr automatically when the host is available. codex-remote terminal disable unregisters only Remote's command and preserves other extensions. Use codex-terminal disable to remove the shared launcher itself.
Feature or platform | Status |
Linux host, Node 24+, Codex 0.163.0 | Tested baseline |
Android pairing and continuing an existing chat | Verified on a real phone |
iPhone pairing | Uses the same native link; end-to-end verification pending |
Creating a new chat from the phone | Verification pending |
Mobile approvals and steering an active task | Verification pending |
macOS or Windows hosts | Untested; requires a compatible native Codex managed-server remote interface |
Other operating systems | Untested; requires Node 24+ and the same native interface |
Sessions started with | Outside the shared server; not migrated by this plugin |
A connected relay does not prove a phone has paired. Check both status and devices list. The plugin makes native remote features easier to access; it cannot bypass account restrictions or add missing native mobile features.
To update, use the installation command from the latest release, then run codex-remote install again. Open a new Codex terminal to load updated tools.
To uninstall, unregister the optional terminal command with codex-remote terminal disable if you enabled it. First decide whether you also want native remote access disabled. If so, run codex-remote disable, then:
codex plugin remove codex-remote@codex-remote-local
codex plugin marketplace remove codex-remote-local
npm uninstall --global --prefix "$HOME/.local" codex-remoteThese removal commands preserve native device pairings and remote preferences. More troubleshooting and answers
On Windows, use the same two plugin removal commands, followed by npm uninstall --global codex-remote for the default-prefix installation above.
The CLI and MCP tools use the existing managed Codex server's local Unix WebSocket. Enable/disable operations use remoteControl/enable and remoteControl/disable with ephemeral: false. They do not restart the daemon. When no daemon exists, an explicit enable/pairing request may start it.
Pairing credentials are short-lived and are not saved by this plugin. QR images and links grant access during pairing: keep real ones private. Codex Remote does not add its own analytics or remote server; native Codex and ChatGPT services still handle the connection.
CODEX_HOME selects the native Codex home. CODEX_REMOTE_CODEX_BIN can select a specific Codex executable. Architecture, lifecycle, and privacy
Official references: Codex app-server, remote connections.
See CONTRIBUTING.md for local setup, checks, and the release workflow. Start with the issue tracker for bugs or suggestions.
This project is licensed under MIT.
GitHub releases are available. This plugin has not been submitted to or approved for the official ChatGPT/Codex plugin directory. Submission preparation, data handling, and license/service information are public.
This server cannot be deployed
Connect AI assistants to explicitly paired computers, servers, and VMs for permitted remote actions.
Use your Mac, Windows or Linux computer from ChatGPT, Claude or Codex: files, commands, documents.
Work on your own computers from Claude or ChatGPT: run commands, edit and search files.
Securely control computers you explicitly pair through files, terminals, processes, screenshots, desktop UI/input, clipboard, browser automation, diagnostics, and document tools.
