One app, one OpenCode plugin, one helper on the computer that runs OpenCode. Install them in this order: plugin → helper → app → pair → verify.
Versions are not interchangeable. Pick the plugin and helper versions from the compatibility table for your app version. The newest app build is the latest release.
| Channel | Updates | Signing lifetime | When to use |
|---|---|---|---|
| App Store / TestFlight | Automatic | Apple-managed | Normal use; requires the build to be available |
| Direct IPA (GitHub Releases) | Manual — download and re-install | 7 days with a free Apple ID, 1 year with a paid account | The App Store build is not available yet, or you want the newest build immediately |
The direct IPA is unsigned. You sign it yourself with your Apple ID using Sideloadly or AltStore — no App Store review, TestFlight, or paid developer account is involved.
The plugin runs inside OpenCode and serves the local bridge on port 38963.
Download the plugin zip from the app release that matches your app version, unpack it, and add a loader so OpenCode picks it up:
# Versions from the compatibility table; replace both.
APP_VERSION=0.1.2
PLUGIN_VERSION=0.1.0
mkdir -p ~/.config/opencode/plugins ~/.config/opencode/open-island-mobile-plugin
curl -fL -o /tmp/open-island-mobile-plugin.zip \
"https://github.com/sithartha/opencode-informer/releases/download/app-v${APP_VERSION}/open-island-mobile-plugin-${PLUGIN_VERSION}.zip"
unzip -o /tmp/open-island-mobile-plugin.zip -d ~/.config/opencode/open-island-mobile-plugin
cat > ~/.config/opencode/plugins/open-island-mobile.js <<EOF
export { default } from "${HOME}/.config/opencode/open-island-mobile-plugin/open-island-mobile.js"
EOF
Restart OpenCode. The bridge should answer on 127.0.0.1:38963; the plugin keeps working
normally if the helper is absent, so a missing helper is not an error at this step.
The helper advertises Bluetooth, hands the phone the bridge address, and asks you to approve pairing.
Download OpenCodeInformerHelper-<version>.dmg from the matching
helper release, open
it, drag OpenCode Informer to Applications, and launch it. Approve the Bluetooth
and Local Network prompts. The menu-bar item shows BLE status and the rendezvous address.
Download the binary for your platform from the matching
helper-crossplatform-v release
(opencode-informer-helper-linux-x86_64, ...-windows-x86_64.exe,
...-macos-aarch64). These binaries are unsigned: expect a SmartScreen warning on
Windows, and on Linux make the file executable:
chmod +x opencode-informer-helper-linux-x86_64
./opencode-informer-helper-linux-x86_64 --open
--open opens the local approval page for pairing. Many desktop Bluetooth adapters do
not support LE advertising; the helper then keeps running in LAN-only mode and the phone
connects by address, without background wake.
Requires iOS 16.4 or later.
Install from the App Store listing, or join the TestFlight build. Nothing else to do.
OpenCodeInformer-<version>-unsigned.ipa from the
latest app release.Optionally verify it against the release’s SHA256SUMS:
shasum -a 256 -c SHA256SUMS
Notes specific to this build:
aps-environment entitlement it does not use (the app
only raises local notifications). Sideloading tools strip or re-sign it; that is
expected.You can try the app without a Mac: the first-run screen offers a Demo with sample sessions.
y/n) on Linux and Windows.| Symptom | Fix |
|---|---|
| App finds no Mac | Same Wi-Fi? Bluetooth on? Helper running and showing a rendezvous address? |
| Pairing prompt never appears | Open the helper menu (macOS) or the approval page at http://127.0.0.1:38964/ (Linux/Windows) |
| App connects but shows nothing | Plugin not loaded — restart OpenCode and check ~/.config/opencode/plugins/open-island-mobile.js points at an existing file |
| No notifications when locked | Allow notifications for the app; keep the helper running. iOS force-quit stops BLE wake until the app is reopened |
| Live Activity stays stale | Expected between wakes; it refreshes on the next BLE wake or app foreground |
| Helper cannot advertise | Many desktop adapters lack LE advertising. It falls back to LAN-only; background wake is unavailable |
| Install fails below iOS 16.4 | The app’s deployment target is 16.4; update iOS or use a newer device |
More detail: plugin, macOS helper, cross-platform helper.