Your next step,
from anywhere.

On your Mac

Make yourself at home.

Start with a working Codex setup on your Mac. Confirm you can open a project and send a prompt using your existing Codex authentication.

Open the downloaded DMG and drag TapCue into Applications. You can also use the Applications folder in your home folder if you do not have administrator access. Eject the DMG and open the installed copy. TapCue must be installed before its background service or updates can run.

Open TapCue on your Mac. Enable its background service and check that both the service and Codex are available. In Projects, add the project folders you want to access from your iPhone.

TapCue only exposes approved projects. Adding a project does not move or upload its folder to the relay.

Bring your devices together

Scan. Pair. You’re connected.

On your Mac, open Pairing and generate a fresh pairing code. On your iPhone, review and agree to the privacy and AI data-sharing disclosure, then open Macs → Add Mac, allow camera access, and scan it.

For local access, put both devices on the same reachable network and allow Local Network access. For remote access, configure your relay connection on the Mac first, then scan its remote pairing code. Relay connections use end-to-end encryption by default. Local connections have different protections; check the connection modes before sending private content.

Pairing codes are temporary and private. Only scan a code shown on a Mac you own or are authorized to use.

On your iPhone

Pick up the conversation.

Choose your Mac and project, then open a session. Read the latest activity, send your next instruction, or inspect the available changes.

When a request needs approval, check its Mac, project, action, and permission scope before responding. Keep the Mac awake and reachable while you work from your phone.

Getting the apps

Have your build ready.

Apple silicon · macOS 14.0 or later · Developer ID signed and notarized.

SHA-256: 7d520f473165fb9a752ec15e9be28bcb0b548afef5dfcb8114fa155ad2f03002

Intel · macOS 14.0 or later · Developer ID signed and notarized.

SHA-256: 2ebdf36fa17ea5119a6f5d29a9e1017d248fa90d473b7696580d090e8057203a

This guide applies to the TapCue iPhone and Mac apps. The initial iPhone release will be free to download. The iPhone download link will appear here when its release is available. Your configured AI services and any infrastructure you operate may have their own costs. If you already have a TapCue build, follow the steps above.

Need help finding the right build or getting started?

Keep TapCue up to date

Update from your Mac.

Choose TapCue → Check for Updates in the Mac menu, or open Settings → App Updates. Review the release notes and choose Download and Update. Tasks and phone connections keep working while the download is verified.

If work is still running, TapCue keeps the update ready for you to install later. Installation restarts TapCue and its background service, so your iPhone may reconnect briefly. Updates preserve your paired devices, projects and local data. A service you disabled stays disabled. TapCue does not update your external Codex installation.

TapCue does not install silently or install a staged update when you quit. If the app is updated but its background service has not recovered, use the update window to retry and check the background permission in System Settings.