From 943485d5a92ae072101c09062090524a146fdfe3 Mon Sep 17 00:00:00 2001 From: Mike Grabowski Date: Sat, 24 Oct 2026 03:29:27 +0400 Subject: [PATCH 1/4] docs(readme): install from the Codex plugin directory Link the official plugin directory listing, add a linked feature summary, and move the GitHub release marketplace commands to CONTRIBUTING.md. Co-Authored-By: Claude Opus 5.5 --- CONTRIBUTING.md | 25 +++++++++++++++++++++++++ README.md | 34 +++++++++++++++------------------- docs/releases.md | 2 +- 3 files changed, 41 insertions(+), 20 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 8f5755e9..12b61b6a 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -91,6 +91,31 @@ logs, and CPU/memory monitoring. Open its Xcode project or use its build-and-run script with a booted simulator UDID. It needs no external app dependencies and is not included in the plugin package. +## Install from the GitHub marketplace + +Most users should install Mobile Dev from the +[Codex plugin directory](README.md#install). To install the prebuilt plugin from +this repository's release marketplace instead: + +```sh +codex plugin marketplace add https://github.com/callstackincubator/codex-mobile-dev-plugin.git --ref release/latest +codex plugin add mobile-dev@mobile-dev +``` + +Open a new chat after installing. The package includes the built plugin and +bundled runtimes; no plugin build or `npm install` is needed. + +Mobile Dev shows a banner when a newer release is ready to install. Click +**Update**, then fully quit and reopen Codex after it finishes. + +You can also update an existing installation from the terminal: + +```sh +codex plugin marketplace upgrade mobile-dev +``` + +Fully quit and reopen Codex after updating. + ## Install the local build From this project directory, after packaging: diff --git a/README.md b/README.md index c69bacfb..02e798b4 100644 --- a/README.md +++ b/README.md @@ -6,29 +6,25 @@ SwiftUI, and other native mobile projects. ## Install -Install the prebuilt plugin from the release marketplace: +**[Add Mobile Dev to Codex](https://chatgpt.com/plugins/plugins_6ac4c117f76881918d3676e851fa4005)** +from the plugin directory, then open a new chat. -```sh -codex plugin marketplace add https://github.com/callstackincubator/codex-mobile-dev-plugin.git --ref release/latest -codex plugin add mobile-dev@mobile-dev -``` - -Open a new chat after installing. The package includes the built plugin and -bundled runtimes; no plugin build or `npm install` is needed. - -Mobile Dev shows a banner when a newer release is ready to install. Click -**Update**, then fully quit and reopen Codex after it finishes. - -You can also update an existing installation from the terminal: - -```sh -codex plugin marketplace upgrade mobile-dev -``` - -Fully quit and reopen Codex after updating. +To install the prebuilt plugin from this repository instead, see +[Install from the GitHub marketplace](CONTRIBUTING.md#install-from-the-github-marketplace). ## Features +- [Live devices beside your chat](#live-devices-beside-your-chat): stream iOS and + Android simulators, emulators, and physical devices. +- [Device control, inspection and annotations](#device-control-inspection-and-annotations): + let Codex tap, type, and inspect your app, and annotate elements for it. +- [Native and JavaScript logs](#native-and-javascript-logs): iOS, Android, and + Metro logs in one filterable view. +- [Live performance monitoring and improvements](#live-performance-monitoring-and-improvements): + CPU, memory, and FPS charts, with recordings Codex can analyze. +- [App storage](#app-storage): browse and watch what your app saves, without + adding code to it. + ### Live devices beside your chat Stream iOS simulators, Android emulators, and connected iPhones, iPads, and Android devices. Show iOS and Android together or use the fullscreen workspace. diff --git a/docs/releases.md b/docs/releases.md index c256f1bc..a4281635 100644 --- a/docs/releases.md +++ b/docs/releases.md @@ -86,7 +86,7 @@ is independent of the source history, so development ignore rules do not exclude force pushes. Older or repeated versions leave the latest payload unchanged. New marketplace commits use `chore(release): release mobile-dev `. -Use the [installation and update commands](../README.md#install). +Use the [installation and update commands](../CONTRIBUTING.md#install-from-the-github-marketplace). The prebuilt marketplace is named `mobile-dev`, separate from the `mobile-dev-local` development marketplace. A release branch does not change repository visibility. From 808951cd3afb8bc99cbb988faa8117c3094c81f9 Mon Sep 17 00:00:00 2001 From: Mike Grabowski Date: Sat, 24 Oct 2026 03:35:19 +0400 Subject: [PATCH 2/4] docs(readme): make intro host-agnostic and lead with features Co-Authored-By: Claude Opus 5.5 --- README.md | 32 +++++++++++++++++--------------- 1 file changed, 17 insertions(+), 15 deletions(-) diff --git a/README.md b/README.md index 02e798b4..e3474b70 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,24 @@ -# Mobile Dev for Codex +# Mobile Dev -Keep iOS and Android devices beside your Codex desktop chat while building, -running, and debugging mobile apps. Mobile Dev works with Expo, React Native, -SwiftUI, and other native mobile projects. +Build, run, and debug iOS and Android apps without leaving your AI coding tool. +Mobile Dev keeps devices beside your agent's chat and works with Expo, React +Native, SwiftUI, and other native mobile projects. + +- [Live devices beside your chat](#live-devices-beside-your-chat): stream iOS and + Android simulators, emulators, and physical devices. +- [Device control, inspection and annotations](#device-control-inspection-and-annotations): + let your agent tap, type, and inspect your app, and annotate elements for it. +- [Native and JavaScript logs](#native-and-javascript-logs): iOS, Android, and + Metro logs in one filterable view. +- [Live performance monitoring and improvements](#live-performance-monitoring-and-improvements): + CPU, memory, and FPS charts, with recordings your agent can analyze. +- [App storage](#app-storage): browse and watch what your app saves, without + adding code to it. ## Install +### Codex + **[Add Mobile Dev to Codex](https://chatgpt.com/plugins/plugins_6ac4c117f76881918d3676e851fa4005)** from the plugin directory, then open a new chat. @@ -14,17 +27,6 @@ To install the prebuilt plugin from this repository instead, see ## Features -- [Live devices beside your chat](#live-devices-beside-your-chat): stream iOS and - Android simulators, emulators, and physical devices. -- [Device control, inspection and annotations](#device-control-inspection-and-annotations): - let Codex tap, type, and inspect your app, and annotate elements for it. -- [Native and JavaScript logs](#native-and-javascript-logs): iOS, Android, and - Metro logs in one filterable view. -- [Live performance monitoring and improvements](#live-performance-monitoring-and-improvements): - CPU, memory, and FPS charts, with recordings Codex can analyze. -- [App storage](#app-storage): browse and watch what your app saves, without - adding code to it. - ### Live devices beside your chat Stream iOS simulators, Android emulators, and connected iPhones, iPads, and Android devices. Show iOS and Android together or use the fullscreen workspace. From 80e1836fa3f2ad1584ba5d646b25b3fa281c6a5b Mon Sep 17 00:00:00 2001 From: Mike Grabowski Date: Sat, 24 Oct 2026 03:36:27 +0400 Subject: [PATCH 3/4] docs(readme): make feature sections and requirements host-agnostic Co-Authored-By: Claude Opus 5.5 --- README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index e3474b70..b8e513c1 100644 --- a/README.md +++ b/README.md @@ -33,7 +33,7 @@ Stream iOS simulators, Android emulators, and connected iPhones, iPads, and Andr ![](/img/screenshot_side_by_side.png) ### Device control, inspection and annotations -Select and boot simulators or emulators, interact with taps and drags, type on supported devices, and let Codex inspect accessibility elements and control your app through MCP tools. Select an element or screen region and leave instructions for Codex, with React Native component and source details when available. +Select and boot simulators or emulators, interact with taps and drags, type on supported devices, and let your agent inspect accessibility elements and control your app through MCP tools. Select an element or screen region and leave instructions for your agent, with React Native component and source details when available. ![](/img/screenshot_annotations.png) @@ -43,7 +43,7 @@ Read iOS unified logs, Android logcat, and Metro console messages together. Foll ![](/img/screenshot_logs.png) ### Live performance monitoring and improvements -Track app CPU and memory, expand individual thread charts, and view device-wide Display FPS on supported devices. Ask Codex to record an interaction, inspect interactive charts in chat, compare runs, and analyze selected ranges. Android recordings include display frame pacing and jank statistics. +Track app CPU and memory, expand individual thread charts, and view device-wide Display FPS on supported devices. Ask your agent to record an interaction, inspect interactive charts in chat, compare runs, and analyze selected ranges. Android recordings include display frame pacing and jank statistics. ![](/img/screenshot_performance.png) @@ -59,9 +59,9 @@ See [storage privacy and review checks](docs/storage-privacy.md). ## Requirements -The prebuilt plugin targets Codex desktop on an Apple Silicon Mac and uses -Codex's bundled Node runtime from its workspace dependency cache. Install the -tools for the platforms you use: +Mobile Dev runs on an Apple Silicon Mac. In Codex desktop, the prebuilt plugin +uses Codex's bundled Node runtime from its workspace dependency cache. Install +the tools for the platforms you use: | Platform or feature | Requirements | | --- | --- | From 9267d00b851c3956fcfb8cd12cd426ab2cb70616 Mon Sep 17 00:00:00 2001 From: Mike Grabowski Date: Sat, 24 Oct 2026 03:37:31 +0400 Subject: [PATCH 4/4] docs(readme): make get started host-agnostic Co-Authored-By: Claude Opus 5.5 --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index b8e513c1..f5faf120 100644 --- a/README.md +++ b/README.md @@ -82,15 +82,15 @@ its device panel, inspection, logs, and performance tools. ## Get started -Open Mobile Dev from the Codex sidebar, or ask Codex to open the simulator beside -this chat. Pick a device from the toolbar; selecting a stopped simulator or AVD +Ask your agent to open the simulator beside this chat. In Codex, you can also +open Mobile Dev from the sidebar. Pick a device from the toolbar; selecting a stopped simulator or AVD boots it. Use the iOS and Android toggles to show either platform or both. Click an iOS simulator or Android screen to focus it, then press **Command-V** to paste text into the device. Paste accepts up to 4,096 printable US-ASCII characters; line breaks and other characters show a notice without sending partial text. -Ask Codex to work with your app, for example: +Ask your agent to work with your app, for example: - “Build and run my Expo app in the simulator beside this chat.” - “Read the app logs and help me fix this error.”