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.
Download deckra-mac-1.1.0.tar.gz
222 KB, for macOS. Download the SHA-256 file
SHA-256a9ad944a54d4fb67bd7752ba64f86be9b36de1ad5cd6f1b8d77acd7397ff330e
Requirements
- A Mac running macOS.
- Node.js 22 or later. Check with
node --version. Install it from nodejs.org or with Homebrew:brew install node. - Claude Code, Codex, or both, installed and signed in so that
claudeorcodexruns in Terminal. - tmux, if you want to start sessions with the
cctanddctlaunchers:brew install tmux. - The Deckra app on your iPhone.
- Deckra Pro, only if you want to use Deckra away from your home network through Deckra Cloud.
Install
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.
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 runshasum -a 256 deckra-mac-1.1.0.tar.gzand compare the result with the SHA-256 above. If they don't match, delete the file and download it again.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.
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)
- Copy the
http://...:7777/?t=...link the installer printed. - In Deckra on your iPhone, open Sessions and tap the + button (Add a Mac).
- 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)
- In Deckra, tap the person icon to open Account and sign in with Apple.
- Tap Pair a Mac. The app shows a single use code that expires in 10 minutes.
On your Mac, run the command the app shows, using your code:
deck pair ABCDE-FGHIJ
If
deckis 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.
- Deckra for Mac 1.0.0: deckra-mac-1.0.0.tar.gz, SHA-256 file
SHA-2568f3fb5545f29dc9c88a747438ae9dcb30231c748a133b024265f4d3ab2ba73d3
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.