cmd+cmd

iPhone screenshots to Codex Desktop.

[ 01 ]

Host · Mac relay

Install cmd+cmd from the App Store on iPhone, then run the Mac relay installer. It starts the relay and prints a private QR.

  1. 01

    Run this on the Mac that has Codex Desktop open after installing cmd+cmd on your iPhone.

    Terminal
    $ curl -fsSL https://www.cmdcmd.click/install.sh | bash

    When the relay is ready, Terminal prints the QR for cmd+cmd on iPhone to scan.

    Prefer to inspect first?

    $ curl -fsSL https://www.cmdcmd.click/install.sh -o install.sh
    $ less install.sh

    Then run bash install.sh.

  2. 02

    The QR contains this Mac's local relay address and private token. Scan it; do not type those values by hand.

  3. 03

    Grant macOS Accessibility permission once so the relay can attach screenshots and context files to Codex Desktop.

[ 02 ]

Phone · Pair & send

Open the App Store version of cmd+cmd, scan the terminal QR, then send from your phone.

  1. 01

    Install cmd+cmd from the App Store, then open it on iPhone.

  2. 02

    In Settings, tap Scan Desktop QR and scan the QR shown in Terminal.

  3. 03

    Send from the Share sheet, a Shortcut, or Back Tap. The screenshot lands in Codex Desktop.

Manual setup · debugging only
Endpoint
http://127.0.0.1:8787/v1/capturesSimulator only. iPhones should scan the terminal QR so the Mac address and token are correct.
Bearer token
CMDCMD_RELAY_TOKENEncoded in the terminal QR.