TapCue

TapCue Support

A little help.
Back to your work.

From your first pairing to your next approval, find the answers you need.

01 / Getting started

Your Mac. Your iPhone.
One conversation.

TapCue connects your iPhone to Codex running on a Mac you control. You’ll need both TapCue apps, a working Codex setup on your Mac, and a connection between the devices.

New to TapCue?

Set up your Mac, choose a project, and pair your iPhone.

Open the setup guide

02 / Common questions

Good questions. Clear answers.

What is TapCue?

TapCue is an independent iPhone companion for Codex sessions running on your Mac. Use it to continue conversations, follow progress, inspect changes, and respond to approvals. Your Mac provides the development environment and runs the work.

Does my Mac need to stay on?

Yes. Keep your Mac awake, connected to the network, and running the TapCue background service. If it sleeps or goes offline, TapCue cannot reach it. Your iPhone may still show cached session summaries.

Can I use TapCue away from home?

Yes, when your Mac has a reachable connection through a configured relay or a trusted VPN. Pair using the remote pairing code for relay access. A local Wi-Fi pairing alone does not make your Mac reachable over cellular.

For the E2E release, the managed relay is hosted in Singapore. Read how the connection works.

Can I connect more than one Mac?

Yes. Pair each Mac separately from the Macs tab. TapCue keeps their sessions, projects, connection states, and approvals separate, so you can see which Mac each task belongs to.

What can I review or approve?

You can inspect available file changes and diffs, read the surrounding conversation, and respond to requests exposed by your Mac’s Codex setup. Check the Mac, project, requested action, and permission scope before approving. Declining a request and stopping a task are different actions.

Approval does not bypass your Mac’s project allowlist or sandbox. Choose a one-time approval when you only intend to allow the current request.

What happens when my iPhone disconnects?

A task can keep running on your Mac while your iPhone is disconnected. A task waiting for your approval will wait for your response. Reopen TapCue and reconnect to catch up with progress; an offline draft is not sent automatically.

Will TapCue notify me while it is in the background?

Open TapCue to see current activity and requests that need attention. Background push notifications are not part of the current app, so do not rely on a push alert to know that a task needs your input.

Do I need a separate TapCue account?

The device-pairing flow does not require a TapCue account. Codex uses the authentication and model-provider settings on your Mac. TapCue does not replace your Codex access or provider subscription.

How do I disconnect a Mac or revoke an iPhone?

Remove the Mac from the Macs tab on your iPhone to clear that connection’s local configuration, credentials, and cached data. On the Mac, open TapCue’s Devices page and revoke the iPhone to end its access. Removing a Mac on the phone does not revoke it on the Mac or delete the Mac’s Codex sessions.

Is TapCue made by OpenAI?

No. TapCue is developed and operated by LunarTear Studio LLC. It is an independent companion and is not affiliated with or endorsed by OpenAI.

03 / Troubleshooting

Let’s get you connected.

Pairing code won’t scan or has expired

  1. Open the Pairing page in TapCue on your Mac and generate a fresh code.
  2. On iPhone, allow camera access in Settings → Apps → TapCue.
  3. Use the local code on the same network, or the remote code for a configured relay.
  4. Keep the code private. If it was shared, generate a new one.

Your Mac appears offline

  1. Wake your Mac and check that it has internet access.
  2. Open TapCue on the Mac and confirm its background service and Codex are available.
  3. For local pairing, check that both devices share a reachable network and that TapCue has Local Network permission on iPhone. Guest Wi-Fi may isolate devices.
  4. For remote pairing, check the relay connection in TapCue on your Mac, or confirm your VPN is connected.
  5. Reopen TapCue on iPhone and pull to refresh. If the Mac’s address changed, pair again using a fresh code.

A project, session, or change is missing

  1. Check that you selected the correct Mac and that it is online.
  2. Confirm the project has been added to TapCue’s Projects page on that Mac.
  3. Refresh the session list or reopen the conversation. An offline list may be out of date.
  4. Use matching iPhone and Mac app versions. After a Mac app update, restart its background service if prompted.

An approval does not go through

  1. Reconnect and check whether the request is still waiting. It may already have been handled on your Mac.
  2. Read the requested permissions and select an available response.
  3. If the action remains blocked, inspect the session on your Mac. Do not disable the sandbox to work around it.

Still stuck? Send a useful report.

In TapCue on your Mac, open Overview and export diagnostic logs. Review the file before sharing it. Automatic redaction helps, but it cannot identify every piece of sensitive information.

Include your TapCue, iOS, and macOS versions; whether you use local Wi-Fi, a VPN, or a relay; the approximate time of the issue; and the steps to reproduce it. Remove private code, credentials, tokens, pairing codes, and personal information from attachments.

Send a bug report

04 / Contact & feedback

We’re here to help.

For support, bug reports, feature suggestions, accessibility feedback, or privacy requests, email us directly.

support@lunartear.studio
Developer & operator
LunarTear Studio LLC

Please contact us from an email address where you can receive a reply. Never send passwords, API keys, device tokens, or pairing codes. Attach diagnostic information only if you choose to share it.