Setup

Use on iPhone

1. Open the bridge in Safari.
2. Use Share → Add to Home Screen.
3. Open the installed app and enter the token from /app/brdg/prod/secrets.json.

Optional userscript

The Claude helper captures the latest relevant exchange, accepts an optional instruction and ZIP, sends it to Codex, and can insert the result back into Claude without submitting it.

Download AI Bridge userscript

1. Install and enable a Safari userscript extension.
2. Download the file above and import it into the extension.
3. Allow it on claude.ai.
4. Open a Claude conversation, tap Send to Codex, enter the bridge token once, review the captured exchange, and send.
5. Automatic continuation is enabled by default. Disable it in the helper when you want to use Insert result without submission.
6. Explicit BRIDGE:FILES requests are handled automatically when possible. Check file request and the manual ZIP fallback remain available.

The script stores the bridge token in the userscript extension's private storage. Attachment readiness is detected from Claude's UI; there is no fixed upload delay.

Phase 3 enables automatic continuation by default. When Claude reports a limit, the exact message and any machine-readable reset time are stored on the bridge. Disable Automatically continue Claude in the helper to use manual insertion.

Continuation notifications

On iPhone, install the PWA to the Home Screen first, open the installed app, and set its access token. Then enable notifications here.

Notifications are not configured in this browser.

Server

The deployment uses one systemd service. Caddy already terminates HTTPS and proxies the public hostname to loopback port 10101.

sudo systemctl status ai-bridge-dev
sudo journalctl -u ai-bridge-dev -f

Runtime files:

• /app/brdg/prod/config.json — listener and workspace IDs
• /app/brdg/prod/secrets.json — access token; keep mode 0600
• /app/brdg/prod/data/projects.json — native Codex thread mappings
• /app/brdg/prod/data/pending_actions.json — queued or limited Claude continuations
• /app/brdg/prod/data/push_subscriptions.json — browser push subscriptions

After editing configuration:

sudo systemctl restart ai-bridge-dev

Current host limitation

This environment blocks unprivileged UID-map creation, so Codex's workspace-write bwrap sandbox cannot currently run file or command tools. Chat turns work, but coding turns that need tools will fail until the VPS/container permits unprivileged user namespaces. Check the service log for the exact sandbox error.