Skip to main content
Version: next

Use It with Codex App

If you already use Codex App on the Mac, you usually do not need to add every Project manually on the iPhone. Workspaces registered and used in Codex App can also show up in the CodexPocket project list.

For people who want the same everyday workspaces on both Mac and iPhone, this is the most natural path.

Diagram of workspaces flowing from Codex App to CodexPocketMac and the iPhone

  1. In Codex App on the Mac, open or register the workspace you use regularly.
  2. Launch CodexPocketMac and confirm that Bridge is running.
  3. Check whether the same workspace appears in the Projects tab on the Mac.
  4. Pull to refresh in Home or Projects on the iPhone.

That makes it easy to open, from the iPhone, the same workspace you normally use on the Mac.

Things that often line up automatically

  • the workspace location
  • the display name of the Project
  • additions, removals, and general ordering of the workspaces you use in Codex App

You do not need to think about the sync mechanism in detail. As a user, it is enough to remember that workspaces visible in Codex App may also appear in the Projects list in CodexPocketMac.

When manual add is faster

  • the workspace you want does not appear in the list
  • you want to rename the display label yourself
  • you want to add a Project from the iPhone right now

In those cases, press + in Projects on the iPhone and add it manually.

Tips for the first use

  • Once the Project appears, open it first and check the Thread list.
  • If the thread you want is not there yet, starting New Thread from the iPhone is usually the fastest path.
  • The real environment still lives on the Mac, so it helps to think of the iPhone as the remote entry point into that same workspace.

Using Codex App together with CodexPocketMac keeps workspace management on the Mac while letting the iPhone handle resume and follow-up.