Repository navigation
Conversation
Lets an agent on this machine drive web pages in the Multiplex app on the user's device. - `mpx bridge` (hidden): started by the app over its own SSH connection; serves `~/.mpx/run/browser-<device>-<install id>.sock` (0700 dir, owner/sticky ancestry checked, peer uid checked on both ends), JSON lines both ways, request `t`/`ttl` stamps and `cancel` for the app's stale-request guard, socket removed on EOF or signal. - `mpx browser …`: open, snapshot (outline with [ref=eN]), click, fill, type, press, select, scroll, wait, eval, console, screenshot (0600 in ~/.mpx/shots), show, close, tabs, status, forward [--open]. `--device` picks among several connected devices; an ambiguous match is an error. - `mpx skill install|print` and a Claude Code plugin (`.claude-plugin/marketplace.json` → `plugin/`), one SKILL.md for both; a test pins the plugin version to the crate's.
CI's newer clippy flags unnecessary_sort_by (live_bridges) and chunks_exact_to_as_chunks (hex_decode, pre-existing on main).
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Lets an agent on this machine open and operate web pages in the Multiplex app on the user's device (Vision Pro / iPad / iPhone). Pairs with the app-side PR in multiplex-term/Multiplex (branch
agent-browser).mpx bridge(hidden) — the app starts it over its own SSH connection (a PTY-less login shell, so the host's PATH applies). It serves a unix socket~/.mpx/run/browser-<device>-<install id>.sock; no TCP port, no sshd forwarding.t/ttland acancelis sent on timeout, so an app that was suspended never replays stale clicks.mpx browser …—open,snapshot(outline with[ref=eN]),click,fill,type,press,select,scroll,wait,eval,console,screenshot,show,close,tabs,status,forward <port> [--open].~/.mpx/shots.--device/MPX_BROWSER_DEVICEpicks among connected devices; an ambiguous match is an error. Without it, the newest device wins and stderr says so.mpx skill install [--agent claude|codex]/mpx skill print, and/plugin marketplace add multiplex-term/mpx-cli→/plugin install multiplex@multiplex-term. Oneplugin/skills/multiplex/SKILL.mdserves both; a test pinsplugin.json's version to the crate's.Release note: the app copy says "mpx 0.2 or later", but
Cargo.tomlis still 0.1.2. Bump it, together withplugin/.claude-plugin/plugin.json, at release.Testing
cargo test: 47 unit tests and 3 integration tests (tests/browser_bridge.rs: a request round-trip through a real bridge process, the actionable no-device error, same-named devices on separate sockets, SIGTERM socket cleanup).cargo clippy --all-targetsis clean.claude plugin validatepasses for the marketplace and for the plugin (--strict); installed into a throwawayCLAUDE_CONFIG_DIR.