A little help.
Then keep moving.

Start with your Mac.

You need an Apple silicon Mac with macOS 15 or later, an iPhone with iOS 18 or later, and an Apple Watch with watchOS 11 or later. Your Mac must stay awake and online. Access with its lid closed is not guaranteed.

1. Download the Mac companion, unzip it, and move codicile to Applications.
2. Open Codex and sign in to an eligible ChatGPT account.
3. Open codicile on your Mac, review the voice-data disclosure, and connect Tailscale. The companion includes remote connectivity; a separate Tailscale Mac app is not required.
4. Create a pairing code. On iPhone, open codicile and tap Scan Mac code. Manual entry is available if the camera cannot be used.
5. Open codicile on your Watch and keep it open until pairing finishes. Review its voice-data disclosure and allow microphone access, then start speaking.

The iPhone and Watch apps are distributed separately from this Mac download. A compatible Codex installation, eligible ChatGPT account, and Tailscale account are required. Their account and service terms apply separately.

If the connection goes quiet.

Check that your Mac is awake, online, and running codicile. Its account and remote-access steps should show Connected. Check microphone permission on the Watch and make sure voice is started rather than muted or stopped.

Codicile reconnects when the network returns. If setup is still waiting, use the retry shown in the app. For an expired pairing code, create a new code on the Mac. For a pending transfer to Watch, keep the Watch app open and retry the transfer on iPhone.

Pick up the same conversation.

Choose a conversation on Watch, speak, and stop voice when finished. On Mac, choose that conversation from codicile’s recent Watch chats and continue in Codex.

A conversation can be active in one interface at a time. Finish active work in the other interface before switching. Codicile releases an idle conversation for the handoff; it does not stop Codex’s active work. What appears in Codex depends on the installed Codex version. Available tools follow your account setup and approval settings.

If a first-time connection asks you to restart Codex, save or finish active work before following that prompt.

Your devices. Your choices.

Revoke access on Mac invalidates previously paired devices. Pair them again to restore access. You can separately revoke voice-data consent on Mac and Watch. Revoking access does not delete Codex conversations or erase all locally saved data. Read the privacy policy for details.

We’re within reach, too.

Email support@codicile.info with the step that failed, your app versions and device models, and whether the Mac reports its account and remote access as connected.

The Mac app can create a diagnostic report when needed. Review it before sharing. Do not send pairing codes, passwords, tokens, private conversation text, raw logs, or microphone audio by email.