Relaydex Local iPhone

Relaydex Local iPhone is a Web/PWA direction based on 1271535149/relaydex-local.

The goal is to control a local desktop Codex session from iPhone Safari without opening a new SSH terminal and without moving Codex execution to the phone.

Current Status

This repository is in planning/prototype stage.

The first implementation target is deliberately narrow:

iPhone Safari over Tailscale
  -> web/PWA UI served by the Mac
  -> Relaydex relay/bridge protocol
  -> local codex app-server
  -> local Codex workspace, files, git, and terminal actions

This is not a public production relay yet. The early milestone is proving that an iPhone browser can pair with the host bridge, list local Codex threads, read a thread, and start a turn.

Based On

The upstream project currently provides:

• phodex-bridge/: Node.js bridge running next to local Codex
• relay/: minimal WebSocket relay server
• android/: Android client using the bridge/relay pairing model
• Docs/: self-hosting and privacy notes

This project starts from that architecture but replaces the Android client path with a browser/PWA client suitable for iPhone Safari.

Non-Goals

• Do not expose codex app-server directly to the public internet.
• Do not make the iPhone run Codex locally.
• Do not build an OpenAI API chat client.
• Do not start by building a native iOS/Swift app.
• Do not treat SSH into the Mac as the product experience.

Documentation

• docs/方案记录.md
• docs/tailscale-first-plan.md
• docs/progress.md
• docs/memory.md

License

No license has been selected for this repository yet.

The upstream Relaydex Local repository is published under the ISC License. If code is copied from upstream, this repository must preserve the required license and attribution files before redistribution.