Guide
Use Codex from your phone
To use Codex from your phone, it has to run on a computer that stays on, and your phone needs a way in. OpenAI’s Codex Remote pairs the ChatGPT app with the ChatGPT desktop app on a Mac or Windows PC. wisp works with the Codex CLI on any computer, Linux included, or on a cloud box, and you open it from the Android app or any phone browser.
wisp Cloud: free during the preview, sign in with GitHub · or run wisp on your own computers, MIT
Three ways in
- Codex Remote (OpenAI): pair the ChatGPT mobile app with the ChatGPT desktop app on macOS or Windows. The host stays awake and signed in, and setup starts from the desktop app, not from the Codex CLI.
- SSH and tmux: run
codexinside tmux on a server and attach from a phone SSH app. It works anywhere and gives you a terminal at phone size. - wisp: the Codex CLI runs headless in its own git worktree on your computer or your cloud wisp, and your phone shows wisp’s own page for it.
On a cloud box, with the laptop shut
- Open grid.trywisp.dev on your phone and press Continue with GitHub.
- Sign in to Codex: Settings → Agents → Sign in. wisp runs
codex login --device-authand shows a code; open the link, type it in, done. Do the same forghif you want pull requests. - Give Codex a task, pick the repo, and lock the phone. Codex keeps working on the server; the report waits for you.
On your own computer
- On the computer with your repos and Codex signed in, run wisp (
npx wisp-agents) and open Machines → Reach this computer from anywhere. Allow the code on grid.trywisp.dev. - On the phone, sign in to wisp Cloud in the Android app, or open grid.trywisp.dev in the browser. The computer is listed as Your computer · via grid: tap Open.
- Start Codex tasks there with that computer’s files and logins. Nothing on it listens on a port: it dialed out.
What you do from the phone
- Start tasks with Codex, or send the same one to Codex and Claude Code and compare.
- Answer it. When Codex asks or a permission blocks it, the card shows the question with a button per answer; ntfy or Telegram can notify you.
- Review and ship. The report shows the diff and the test run; Ship it opens the pull request.
Questions
- Does it work on iPhone?
- Yes, in the browser: grid.trywisp.dev opens your cloud wisp and every computer you added. The native wisp app is Android only for now.
- Can the computer run Linux?
- Yes. wisp runs the Codex CLI on macOS, Linux and Windows (beta); the cloud box is Linux.
- Which Codex plan do I need?
- The one you already use: Codex signs in with your ChatGPT account or an API key, and its limits apply. wisp doesn’t resell model usage.
- Is Codex Remote better?
- If you live in the ChatGPT desktop app on a Mac or PC that stays awake, it’s the most direct. wisp fits when you use the Codex CLI, Linux, several computers or other agents, or want Codex to keep going with every computer off.
Related guides
- Use wisp CloudYour own wisp on a server: sign in with GitHub, close the laptop, read the report on your phone.
- Beyond Claude Code Remote ControlRemote Control drives one Claude Code process on one awake computer. wisp adds Codex and the rest, every computer, and a cloud box.
- Reach your own computer from anywhereAdd your desktop to wisp Cloud from its Machines: your phone and other computers open it, with no SSH, Tailscale or open port.