Your first Codex task. From your phone.
Connect your Mac. Start a Codex task. Review the result from your phone.
Put your Mac within reach.
Install Vibe Remote and run setup in Terminal. Authorize your Mac with GitHub, then scan the QR code with your phone.
Links & references
Pair your phone
vibe-remote setupOpen your project. Start Codex.
With Codex installed and signed in, run this command inside your project directory. Your paired phone can continue the managed session.
Links & references
Start managed Codex
vibe-remote codexMake the first task easy to verify.
Ask Codex to investigate one failing test. Follow progress on your phone and review any questions or approval requests.
Links & references
Choose one test
Give Codex a clear starting point.
Follow the work
Read progress on your phone.
Answer when needed
Review the request and respond.
Know which session you are continuing.
A managed session continues across Mac and phone. A standard codex session forks on mobile; it is not parallel control of the original Terminal session.
| What matters | Managed session | Standard session |
|---|---|---|
| Launch command | vibe-remote codex | codex |
| Phone continuation | Same managed session | Forked continuation |
| Choose it for | Mac-to-phone handoff | Continuing existing work as a fork |
Check what changed, right from your phone.
Check the diff, changed file, and test output. Need another check? Open the Mac terminal from the same mobile workspace.
Links & references
Inspect the diff
Does the change fit the task?
Read the file
Does the surrounding code make sense?
Check the test
Did the relevant test pass?
A few useful details.
Links & references
Can I start a new Codex session from my phone?
Yes. Set up and pair your Mac first. You can then start new Codex sessions and resume managed sessions from your phone. Codex must be installed and signed in on the Mac.
Which Mac and phone do I need?
Use macOS 13 Ventura or newer on an Apple silicon or Intel Mac. Pair an iPhone or Android phone and open the Vibe Remote mobile web app.
Does my Mac need to stay awake?
Yes. Keep it powered, awake, and online. Your Mac runs Codex and performs the file and terminal actions.
Where does my code go?
Vibe Remote runs work on your Mac and encrypts phone-to-Mac work content end to end. Your AI provider may separately receive prompts and code under its policy and your settings.
About this guide
By Vibe Remote team · Updated