clawdex-mobile 5.0.2 → 5.0.4

package/README.md

@@ -1,245 +1,111 @@
 # Clawdex Mobile
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/Mohit-Patil/clawdex-mobile/main/apps/mobile/assets/brand/app-icon.png" alt="Clawdex app icon" width="112" />
+  <img src="https://raw.githubusercontent.com/Mohit-Patil/clawdex-mobile/main/screenshots/social/clawdex-social-poster-1200x675.png" alt="Clawdex social banner" width="100%" />
 </p>
 
-Control Clawdex from your phone using an Expo React Native app (`apps/mobile`) and a Rust bridge (`services/rust-bridge`) running on your host machine.
+Run Codex or OpenCode from your phone. `clawdex-mobile` ships the bridge CLI plus bundled Rust bridge binaries for supported hosts, and the mobile app pairs to that bridge over Tailscale or local LAN.
 
-This project is intended for trusted/private networking (Tailscale or local LAN). Do not expose the bridge publicly.
+This project is for trusted/private networking only. Do not expose the bridge publicly.
 
 ## What You Get
 
-- Mobile chat with Clawdex
-- Voice-to-text transcription (push-to-talk)
-- Live run/activity updates over WebSocket
-- Plan/default collaboration mode support
-- Clarification and approval flows in-app
-- File/image attachments from workspace and phone
-- Chat-scoped Git actions (status/diff/commit/push)
-- Bridge-backed terminal execution
+- Mobile chat for Codex and OpenCode
+- Live run updates over WebSocket
+- Approval and clarification flows in-app
+- Voice-to-text, attachments, terminal, and Git actions
+- One mobile shell backed by a private host bridge
 
 ## Quick Start
 
-## Download Mobile App
+Before you start:
 
-- Android APK: download from the latest GitHub release assets  
-  <https://github.com/Mohit-Patil/clawdex-mobile/releases/latest>
-- iOS (TestFlight): share your TestFlight invite/public link with testers : https://testflight.apple.com/join/4GRsQQKF 
+- Node.js 20+
+- npm 10+
+- `git`
+- `codex` in `PATH` for the default Codex flow
+- `opencode` in `PATH` if you want the OpenCode flow
 
-Recommended release-note format for Android:
+Install the mobile app:
 
-- `Android APK: <direct asset URL>`
-- `SHA-256: <apk checksum>`
+- Android APK: <https://github.com/Mohit-Patil/clawdex-mobile/releases/latest>
+- iOS: <https://apple.co/4rNAHRF>
 
-### Option A: Published CLI (recommended)
+Install the CLI and start the bridge:
 
 ```bash
 npm install -g clawdex-mobile@latest
 clawdex init
 ```
 
-This is the primary starting point.
-
-Published npm releases bundle prebuilt Rust bridge binaries for `darwin-arm64`, `darwin-x64`, `linux-x64`, and `win32-x64`, so supported hosts do not need to compile the bridge during normal startup. The interactive shell-based setup helpers are still macOS/Linux-oriented today.
-
-`clawdex init` does not run a project-local `npm install`. The global package install is the only npm install needed for the published bridge flow.
-
-The published CLI package is bridge-only. It does not install Expo, React Native, or the mobile app source tree.
+Then open the mobile app and scan the pairing QR.
 
-`clawdex init` guides you through:
+The npm package is bridge-only. It does not install Expo or the mobile source tree. On supported macOS, Linux, and Windows hosts it uses bundled bridge binaries, so normal startup does not compile Rust.
+The current interactive setup helpers are still macOS/Linux-oriented.
 
-1. bridge mode selection: `Local (LAN)` or `Tailscale`
-2. secure bridge config generation (`.env.secure`)
-3. phone readiness checks for selected mode
-4. optional bridge launch in the foreground (release build)
-
-This flow is bridge-only. The mobile app is already shipped, so no Expo dev server is required to pair your phone.
-
-When the bridge starts, it prints a pairing QR:
-
-- preferred: QR contains both `bridgeUrl + bridgeToken` (one-scan onboarding)
-- fallback: token-only QR if host is not a phone-connectable address
-
-Typical lifecycle:
+Typical operator flow:
 
 ```bash
-# install/update once
 npm install -g clawdex-mobile@latest
-
-# onboarding + start bridge
 clawdex init
-
-# stop services later
 clawdex stop
 ```
 
-### Option B: Monorepo checkout
-
-```bash
-npm install
-npm run setup:wizard
-```
-
-Use `npm run setup:wizard -- --no-start` to configure only (no bridge start).
-
-## Project Layout
-
-- `apps/mobile`: Expo client (UI + API client)
-- `services/rust-bridge`: primary bridge (WebSocket JSON-RPC + `codex app-server` adapter)
-- `services/mac-bridge`: legacy TypeScript bridge (reference only)
-- `scripts/`: onboarding/runtime helper scripts
-- `docs/`: setup, troubleshooting, architecture notes
+## OpenCode Setup
 
-## Prerequisites
-
-- macOS or Linux
-- Node.js 20+
-- npm 10+
-- `codex` CLI in `PATH`
-- `git` in `PATH`
-- iOS app installed (TestFlight/App Store/dev build)
-- Tailscale on host + phone (recommended for remote/private networking)
-
-Optional for simulators/emulators:
-
-- Xcode + iOS Simulator
-- Android Studio + Android Emulator
-
-## Day-to-Day Commands
-
-From repo root:
-
-- `npm run setup:wizard` — guided secure setup + optional bridge start
-- `npm run stop:services` — stop running bridge (and local Expo if running)
-- `npm run secure:setup` — generate/update secure env
-- `npm run secure:bridge` — start rust bridge from `.env.secure` (release profile)
-- `npm run secure:bridge:dev` — start rust bridge in dev profile
-- `npm run mobile` — start Expo
-- `npm run ios` — start Expo (iOS target)
-- `npm run android` — start Expo (Android target)
-- `npm run teardown` — interactive cleanup
-- `npm run lint` / `npm run typecheck` / `npm run build`
-
-Published CLI:
-
-- `clawdex init`
-- `clawdex stop`
-- `clawdex upgrade` / `clawdex update`
-- `clawdex version`
-
-## Bridge Start Flow
-
-Recommended:
+OpenCode is supported directly from the CLI now.
 
 ```bash
+npm install -g opencode-ai
 npm install -g clawdex-mobile@latest
-clawdex init
-```
-
-Monorepo/manual flow:
-
-```bash
-# from repo root
-npm install
-npm run secure:setup
-npm run secure:bridge
+clawdex init --engine opencode
 ```
 
-Keep `npm run secure:bridge` running in foreground. It prints pairing QR and bridge logs.
-
-On supported published installs, this uses the bundled bridge binary directly instead of compiling Rust on startup. Source checkouts still build from Cargo when a packaged binary is unavailable.
+That writes `BRIDGE_ACTIVE_ENGINE=opencode` to `.env.secure` and uses OpenCode as the preferred runtime when the bridge starts.
 
-Published CLI installs write `.env.secure` for the bridge and skip repo-only mobile env files.
+Notes:
 
-Then open the installed mobile app and pair it:
+- `clawdex init` without `--engine` still defaults to Codex.
+- If both CLIs are installed, the bridge can surface chats from both engines in the mobile app.
+- To switch later, rerun `clawdex init --engine codex` or `clawdex init --engine opencode`.
 
-- preferred: scan the bridge QR to autofill URL + token
-- fallback: enter the bridge URL and token manually
+## Monorepo Development
 
-For local mobile development only, start Expo from the repo:
+If you are working from source:
 
 ```bash
+npm install
+npm run setup:wizard
 npm run mobile
 ```
 
-## Onboarding In App
-
-On first launch (or after reset):
-
-1. start the bridge on your server
-2. scan bridge QR to autofill URL + token
-3. use `Test Connection` (health + authenticated RPC check)
-4. tap `Continue`
-
-## EAS Builds (Short)
-
-Run EAS commands from `apps/mobile` (that is where `app.json` and `eas.json` live):
-
-```bash
-cd apps/mobile
-eas build --platform ios --profile preview
-eas build --platform android --profile preview
-```
-
-For complete build/submit guidance, see [`docs/eas-builds.md`](docs/eas-builds.md).
-
-## Local Builds (No EAS Cloud)
-
-Run from `apps/mobile`:
-
-```bash
-cd apps/mobile
-```
-
-iOS:
+For an OpenCode-first repo checkout:
 
 ```bash
-# iOS Simulator
-npx expo run:ios
-
-# Connected iPhone
-npx expo run:ios --device
-```
-
-Android:
-
-```bash
-# Android emulator or connected Android device
-npx expo run:android
+npm run setup:wizard -- --engine opencode
 ```
 
-Optional local EAS build:
-
-```bash
-# Requires local Android SDK / Xcode setup
-eas build --platform android --profile preview --local
-```
-
-## Documentation Map
-
-- Setup + operations: [`docs/setup-and-operations.md`](docs/setup-and-operations.md)
-- Troubleshooting: [`docs/troubleshooting.md`](docs/troubleshooting.md)
-- Realtime sync limits/mitigations: [`docs/realtime-streaming-limitations.md`](docs/realtime-streaming-limitations.md)
-- Voice transcription internals: [`docs/voice-transcription.md`](docs/voice-transcription.md)
-- Open-source license obligations: [`docs/open-source-license-requirements.md`](docs/open-source-license-requirements.md)
-- App review template: [`docs/app-review-notes.md`](docs/app-review-notes.md)
-- App-server/CLI gap tracking: [`docs/codex-app-server-cli-gap-tracker.md`](docs/codex-app-server-cli-gap-tracker.md)
+Use `npm run setup:wizard -- --no-start` if you only want to write config.
 
-## Open Source License Requirements
+## Main Commands
 
-Follow project requirements in:
-
-- `LICENSE`
-- `docs/open-source-license-requirements.md`
-
-## Development Checks
-
-From repo root:
-
-```bash
-npm run lint
-npm run typecheck
-npm run build
-npm run test
-```
+- `clawdex init [--engine codex|opencode] [--no-start]`
+- `clawdex stop`
+- `clawdex upgrade` / `clawdex update`
+- `clawdex version`
+- `npm run setup:wizard`
+- `npm run secure:bridge`
+- `npm run mobile`
+- `npm run ios`
+- `npm run android`
+- `npm run stop:services`
+- `npm run teardown`
+
+## Docs
+
+- Setup + operations: <https://github.com/Mohit-Patil/clawdex-mobile/blob/main/docs/setup-and-operations.md>
+- Troubleshooting: <https://github.com/Mohit-Patil/clawdex-mobile/blob/main/docs/troubleshooting.md>
+- Realtime sync limits/mitigations: <https://github.com/Mohit-Patil/clawdex-mobile/blob/main/docs/realtime-streaming-limitations.md>
+- Voice transcription internals: <https://github.com/Mohit-Patil/clawdex-mobile/blob/main/docs/voice-transcription.md>
+- EAS builds: <https://github.com/Mohit-Patil/clawdex-mobile/blob/main/docs/eas-builds.md>
+- Open-source/license notes: <https://github.com/Mohit-Patil/clawdex-mobile/blob/main/docs/open-source-license-requirements.md>

package/bin/clawdex.js

@@ -10,10 +10,11 @@ function printUsage() {
   console.log(`Usage: clawdex <command> [options]
 
 Commands:
-  init [--no-start]
+  init [--no-start] [--engine codex|opencode]
       Run interactive bridge onboarding and secure setup.
       By default, this also starts the secure bridge in the foreground.
       Use --no-start to configure only.
+      Use --engine to set the preferred backend written to .env.secure.
 
   stop
       Stop bridge services for this project.

package/docs/setup-and-operations.md

@@ -2,6 +2,24 @@
 
 This guide is the detailed companion to the top-level `README.md`.
 
+## Choosing a Runtime
+
+The bridge defaults to `codex`.
+
+Use the setup wizard to make `opencode` the preferred engine:
+
+```bash
+clawdex init --engine opencode
+```
+
+From a source checkout, the equivalent command is:
+
+```bash
+npm run setup:wizard -- --engine opencode
+```
+
+That writes `BRIDGE_ACTIVE_ENGINE=opencode` into `.env.secure`. To switch back, rerun setup with `--engine codex` or edit `.env.secure` directly.
+
 ## Onboarding Output Cues
 
 After `clawdex init`, expected sequence:
@@ -11,7 +29,7 @@ After `clawdex init`, expected sequence:
 3. A pairing QR is printed for the mobile app
 4. Bridge logs stay attached until you stop the process
 
-Published npm releases bundle prebuilt bridge binaries for `darwin-arm64`, `darwin-x64`, `linux-x64`, and `win32-x64`. On those hosts, normal bridge startup does not require a Rust compile.
+Published npm releases bundle prebuilt bridge binaries for `darwin-arm64`, `darwin-x64`, `linux-x64`, `linux-arm64`, `linux-armv7l`, and `win32-x64`. On those hosts, normal bridge startup does not require a Rust compile.
 
 `clawdex init` does not run a project-local `npm install` for the published CLI path. The only required npm install there is `npm install -g clawdex-mobile@latest`.
 
@@ -31,6 +49,12 @@ npm install
 npm run secure:setup
 ```
 
+To generate OpenCode-first config instead:
+
+```bash
+BRIDGE_ACTIVE_ENGINE=opencode npm run secure:setup
+```
+
 Creates/updates:
 
 - `.env.secure` (bridge runtime config + token)
@@ -42,6 +66,14 @@ Creates/updates:
 npm run secure:bridge
 ```
 
+If you want a one-off OpenCode launch without rewriting `.env.secure`:
+
+```bash
+BRIDGE_ACTIVE_ENGINE=opencode npm run secure:bridge
+```
+
+`codex` remains the default. When both CLIs are available, the bridge can start both backends and merge chat lists while still routing each thread by engine.
+
 ### 4) Pair from the mobile app
 
 Open the installed mobile app on your phone, then scan the bridge QR. If needed, enter the bridge URL manually (for example `http://100.x.y.z:8787` or `http://192.168.x.y:8787`). The chosen bridge URL is stored on-device and can be changed later in Settings.
@@ -96,6 +128,12 @@ npm run teardown -- --yes
 | `BRIDGE_AUTH_TOKEN` | required auth token |
 | `BRIDGE_ALLOW_QUERY_TOKEN_AUTH` | query-token auth fallback |
 | `CODEX_CLI_BIN` | codex executable |
+| `BRIDGE_ACTIVE_ENGINE` | preferred backend (`codex` default, `opencode` optional) |
+| `OPENCODE_CLI_BIN` | opencode executable for dual-engine startup |
+| `BRIDGE_OPENCODE_HOST` | loopback host for spawned opencode server |
+| `BRIDGE_OPENCODE_PORT` | loopback port for spawned opencode server |
+| `BRIDGE_OPENCODE_SERVER_USERNAME` | basic-auth username passed to opencode server |
+| `BRIDGE_OPENCODE_SERVER_PASSWORD` | basic-auth password passed to opencode server |
 | `BRIDGE_WORKDIR` | absolute working directory for terminal/git |
 | `BRIDGE_ALLOW_OUTSIDE_ROOT_CWD` | allow terminal/git `cwd` outside `BRIDGE_WORKDIR` |
 

package/package.json

@@ -1,6 +1,16 @@
 {
   "name": "clawdex-mobile",
-  "version": "5.0.2",
+  "version": "5.0.4",
+  "description": "Private-network mobile bridge and CLI for Codex and OpenCode",
+  "keywords": [
+    "codex",
+    "opencode",
+    "mobile",
+    "bridge",
+    "expo",
+    "react-native"
+  ],
+  "license": "MIT",
   "homepage": "https://github.com/Mohit-Patil/clawdex-mobile#readme",
   "repository": {
     "type": "git",

package/scripts/bridge-binary.js

@@ -24,6 +24,19 @@ const SUPPORTED_RUNTIME_TARGETS = {
     rustTarget: "x86_64-unknown-linux-gnu",
     binaryName: "codex-rust-bridge",
   },
+  "linux-arm64": {
+    platform: "linux",
+    arch: "arm64",
+    rustTarget: "aarch64-unknown-linux-gnu",
+    binaryName: "codex-rust-bridge",
+  },
+  "linux-armv7l": {
+    platform: "linux",
+    arch: "arm",
+    machine: ["armv7l", "armv8l"],
+    rustTarget: "armv7-unknown-linux-gnueabihf",
+    binaryName: "codex-rust-bridge",
+  },
   "win32-x64": {
     platform: "win32",
     arch: "x64",
@@ -36,11 +49,19 @@ function repoRoot() {
   return path.resolve(__dirname, "..");
 }
 
-function resolveRuntimeTarget(platform = os.platform(), arch = os.arch()) {
+function currentMachine() {
+  return typeof os.machine === "function" ? os.machine() : "";
+}
+
+function resolveRuntimeTarget(platform = os.platform(), arch = os.arch(), machine = currentMachine()) {
   for (const [target, metadata] of Object.entries(SUPPORTED_RUNTIME_TARGETS)) {
-    if (metadata.platform === platform && metadata.arch === arch) {
-      return target;
+    if (metadata.platform !== platform || metadata.arch !== arch) {
+      continue;
+    }
+    if (metadata.machine && !metadata.machine.includes(machine)) {
+      continue;
     }
+    return target;
   }
   return null;
 }

package/scripts/setup-secure-dev.sh

@@ -9,6 +9,8 @@ fi
 SECURE_ENV_FILE="$ROOT_DIR/.env.secure"
 MOBILE_ENV_FILE="$ROOT_DIR/apps/mobile/.env"
 MOBILE_ENV_EXAMPLE="$ROOT_DIR/apps/mobile/.env.example"
+BRIDGE_ACTIVE_ENGINE="${BRIDGE_ACTIVE_ENGINE:-codex}"
+OPENCODE_CLI_BIN="${OPENCODE_CLI_BIN:-opencode}"
 
 upsert_env_key() {
   local file="$1"
@@ -226,6 +228,15 @@ case "$BRIDGE_NETWORK_MODE" in
     ;;
 esac
 
+case "$BRIDGE_ACTIVE_ENGINE" in
+  codex|opencode)
+    ;;
+  *)
+    echo "error: BRIDGE_ACTIVE_ENGINE must be 'codex' or 'opencode'." >&2
+    exit 1
+    ;;
+esac
+
 if [[ -n "$BRIDGE_HOST" ]]; then
   HOST_SOURCE="override"
 else
@@ -257,7 +268,9 @@ BRIDGE_HOST=$BRIDGE_HOST
 BRIDGE_PORT=$BRIDGE_PORT
 BRIDGE_AUTH_TOKEN=$BRIDGE_TOKEN
 BRIDGE_ALLOW_QUERY_TOKEN_AUTH=true
+BRIDGE_ACTIVE_ENGINE=$BRIDGE_ACTIVE_ENGINE
 CODEX_CLI_BIN=codex
+OPENCODE_CLI_BIN=$OPENCODE_CLI_BIN
 BRIDGE_WORKDIR=$ROOT_DIR
 EOT
 
@@ -276,6 +289,7 @@ echo ""
 echo "Bridge network mode: $BRIDGE_NETWORK_MODE"
 echo "Bridge host: $BRIDGE_HOST ($HOST_SOURCE)"
 echo "Bridge port: $BRIDGE_PORT"
+echo "Preferred engine: $BRIDGE_ACTIVE_ENGINE"
 echo "Token source: $SECURE_ENV_FILE"
 if has_local_mobile_workspace; then
   echo "Mobile env updated: $MOBILE_ENV_FILE"