# Codex remote

> Run Codex on your box from the ChatGPT desktop app, with every edit syncing back to your Mac.

URL: https://prized.dev/docs/codex

Picked the ChatGPT app in [`npx prized`](https://prized.dev/docs/terminal-signup) on a Mac with the app installed? Your box and synced folder are already there: open the app and pick the project. If you installed the app afterwards, add the box below.

## Add your box [#add-your-box]

With Prized set up on this Mac ([Quickstart](https://prized.dev/docs/quickstart)), open **Settings > Connections** in the ChatGPT app:

1. **Click Add** under SSH connections from this Mac.

   ![The Connections page in the ChatGPT app's settings, with an Add button under SSH connections from this Mac](https://prized.dev/docs/codex/ssh-add.webp)

2. **Tick your box** and click **Add**. It is listed by its name.

   ![The Add SSH Connection dialog listing the box, fig, with a checkbox](https://prized.dev/docs/codex/ssh-pick.webp)

3. **Check it says Connected**, then pick a project on the box; synced projects are in `~/code`.

   ![The saved connection, fig, switched on and Connected](https://prized.dev/docs/codex/ssh-connected.webp)

> Skipped ChatGPT during setup? Run `prized setup --agent chatgpt` to sign Codex in on the box. The box gets its own sign-in, so it never signs out the app on your Mac.

## From your phone [#from-your-phone]

The ChatGPT mobile app connects to the box directly, no Mac needed:

1. Open the box in the [dashboard](https://prized.dev/dashboard), go to **Settings**, and click **Set up** beside **Phone access**. Generate the password; it is shown once.
2. In the ChatGPT app, open **Settings > Connections > Add SSH host** and paste the host, port, username, and password.

* **One password per box.** A new one replaces the old, and **Revoke** ends it.
* **Connecting wakes a paused box.**
* **A busy gateway may close a new connection.** Wait briefly and reconnect with the same phone password; this does not revoke it.
* **Terminal only.** No port forwarding; use `prized ports` on your Mac.
* **Idle connections close** after about fifteen minutes; the app reconnects on its own.

No **Add SSH host**? OpenAI is still rolling it out; update the app and look again.
