Version 1.1.0

Deckra for Mac

Deckra for Mac connects the Deckra iPhone app to the Claude Code and Codex sessions on your Mac. It shows each session's status and conversation on your phone, and lets you reply to sessions it can identify safely.

Deckra for Mac 1.1.0

Download deckra-mac-1.1.0.tar.gz
222 KB, for macOS. Download the SHA-256 file

SHA-256
a9ad944a54d4fb67bd7752ba64f86be9b36de1ad5cd6f1b8d77acd7397ff330e

Requirements

Install

  1. Open Terminal and download the package and its SHA-256 file into your Downloads folder:

    cd ~/Downloads
    curl -fLO https://deck-relay-c6b560.fly.dev/download/deckra-mac-1.1.0.tar.gz
    curl -fLO https://deck-relay-c6b560.fly.dev/download/deckra-mac-1.1.0.tar.gz.sha256

    You can use the download links above instead, but Safari may unpack the archive by itself. If it does, use the Terminal commands.

  2. Check the download:

    shasum -a 256 -c deckra-mac-1.1.0.tar.gz.sha256

    It should print deckra-mac-1.1.0.tar.gz: OK. You can also run shasum -a 256 deckra-mac-1.1.0.tar.gz and compare the result with the SHA-256 above. If they don't match, delete the file and download it again.

  3. Extract it into your home folder. This creates ~/deckra-mac:

    tar -xzf deckra-mac-1.1.0.tar.gz -C ~

    Keep the folder in your home folder, not in Desktop, Documents or Downloads. macOS blocks background services from reading those folders, so the installer refuses to run from them.

  4. Run the installer:

    cd ~/deckra-mac
    ./install.sh

At the end the installer prints a private link that looks like http://192.168.1.20:7777/?t=.... You need it to connect your iPhone. Running ./install.sh again is safe: it repairs the hooks and the service and prints the link again.

Deckra uses port 7777. If another app already uses it, the installer picks the next free port and says so. To choose the port yourself, run ./install.sh --port 7788.

If you use Codex, open Codex once and trust the new Deckra hooks with /hooks.

Update from 1.0

If Deckra for Mac 1.0 is already on this Mac, download and check 1.1.0 with steps 1 and 2 above. Then extract it over your existing folder and run the installer again:

cd ~/Downloads
tar -xzf deckra-mac-1.1.0.tar.gz -C ~
cd ~/deckra-mac
./install.sh

You don't need to uninstall 1.0 first. The installer keeps ~/.claude-deck/config.json, so your access token, your port and any Deckra Cloud pairing stay the same, and you don't need to add the Mac to the iPhone app again. If Codex asks you to trust the Deckra hooks again, do it with /hooks.

Connect your iPhone

On the same network (free)

  1. Copy the http://...:7777/?t=... link the installer printed.
  2. In Deckra on your iPhone, open Sessions and tap the + button (Add a Mac).
  3. Paste the link and tap Add. Allow local network access when iOS asks.

The phone and the Mac must be on the same Wi-Fi network. Anyone with this link can see and reply to your sessions, so keep it private. Never forward the Deckra port on your router.

From anywhere with Deckra Cloud (Deckra Pro)

  1. In Deckra, tap the person icon to open Account and sign in with Apple.
  2. Tap Pair a Mac. The app shows a single use code that expires in 10 minutes.
  3. On your Mac, run the command the app shows, using your code:

    deck pair ABCDE-FGHIJ

    If deck is not found, run the installer directly from the Deckra folder:

    cd ~/deckra-mac
    ./install.sh --relay-url https://deck-relay-c6b560.fly.dev --pair ABCDE-FGHIJ

    Add --device-name "Studio Mac" to choose the name the app shows for this Mac.

The app finishes pairing by itself once the Mac connects. The pairing uses the access token in ~/.claude-deck/config.json. If that token changes or the file is deleted, pair the Mac again.

Uninstall

cd ~/deckra-mac
./uninstall.sh

This stops the service and removes the LaunchAgent, the Deckra hooks and the Deckra deck, cct and dct links. The installer saves a copy of a settings file before it changes it, with .deck-backup- in the name. Uninstall leaves the copies of settings files that were already there, and those copies still contain the Deckra hooks, so delete them once you no longer need them. Uninstall also keeps ~/.claude-deck. To remove everything, also run rm -rf ~/.claude-deck ~/deckra-mac. If you paired the Mac with Deckra Cloud, remove it in the app as well.

Earlier versions

Use 1.1.0 for a new install. Earlier versions stay here so that the links and checksums in their README files keep working.

Support

Email puerh.consulting@gmail.com with your Mac model, the macOS and Node.js versions, whether you connect on the same network or through Deckra Cloud, and the exact error. Never send your access token or the ?t= link.