mobile-debug-mcp 0.35.0 → 0.37.0

package/.cursor-plugin/marketplace.json

@@ -9,7 +9,7 @@
   "plugins": [
     {
       "name": "mobile-debug-tools",
-      "source": "./agent-plugin",
+      "source": "./agent-plugin/cursor",
       "description": "Inspect and debug Android and iOS apps with the mobile-debug-mcp server."
     }
   ]

package/.github/workflows/ci.yml

@@ -34,7 +34,7 @@ jobs:
           node --input-type=module - "$RUNNER_TEMP/mobile-debug-package.json" <<'JS'
           import fs from 'node:fs'
           const files = new Set(JSON.parse(fs.readFileSync(process.argv[2], 'utf8'))[0].files.map(file => file.path))
-          for (const file of ['src/debugger/java/DebuggerWorker.java', 'dist/debugger/worker.js', 'dist/debugger/protocol.js', 'dist/runtime/action-results.js', 'dist/server/definitions/input.js', 'dist/server/schemas/debugger-schema.js', 'dist/server/handlers/tool-handlers.js', 'dist/interact/adjustment/adjustment.js', 'dist/interact/targeting/find-element.js', 'dist/interact/waits/ui-wait.js', 'dist/interact/assertions/state-assertion.js', 'dist/observe/network/index.js', 'dist/runtime/clock.js', 'dist/contracts/target.js', 'dist/contracts/execution-controls.js', 'dist/server/handlers/manage.js', 'dist/server/handlers/input.js', 'dist/server/handlers/journey.js']) {
+          for (const file of ['src/debugger/java/DebuggerWorker.java', 'src/debugger/lldb/worker.py', 'src/debugger/lldb/inspection.py', 'src/debugger/lldb/breakpoints.py', 'dist/debugger/ios.js', 'dist/debugger/ios-worker.js', 'dist/debugger/worker.js', 'dist/debugger/protocol.js', 'dist/runtime/action-results.js', 'dist/server/definitions/input.js', 'dist/server/schemas/debugger-schema.js', 'dist/server/handlers/tool-handlers.js', 'dist/interact/adjustment/adjustment.js', 'dist/interact/targeting/find-element.js', 'dist/interact/waits/ui-wait.js', 'dist/interact/assertions/state-assertion.js', 'dist/observe/network/index.js', 'dist/runtime/clock.js', 'dist/contracts/target.js', 'dist/contracts/execution-controls.js', 'dist/server/handlers/manage.js', 'dist/server/handlers/input.js', 'dist/server/handlers/journey.js']) {
             if (!files.has(file)) throw new Error(`Missing debugger package file: ${file}`)
           }
           JS

package/README.md

@@ -10,6 +10,11 @@ Android, iOS, and Kotlin Multiplatform projects are supported. Flutter and React
 Native have not been tested. Platform and device limitations are described in the
 [tool reference](docs/tools/TOOLS.md).
 
+Use `responseMode: "compact"` for bounded interaction and journey summaries.
+Retrieve retained details without replaying input with
+[`get_interaction_diagnostics`](docs/tools/compact-interactions.md); debug output
+remains available.
+
 ## What you can use it for
 
 Mobile Debug Tools gives a coding agent access to a running app, so development
@@ -28,10 +33,10 @@ can include feedback from the device as well as the source code. For example:
 - **Investigate an app failure.** Collect logs, screenshots and a debug snapshot
   around a failing action to understand what happened. [Evidence
   correlation](docs/tools/correlated-evidence.md) links observations to the action.
-- **Investigate Android performance or runtime behaviour.** Capture a
-  [Perfetto trace](docs/tools/system-traces.md) during a slow flow, or attach the
+- **Investigate mobile performance or runtime behaviour.** Capture a
+  [Perfetto or iOS simulator Instruments trace](docs/tools/system-traces.md) during a slow flow, or attach the
   [runtime debugger](docs/tools/debugger.md) to a debuggable app to inspect
-  breakpoints, call stacks and locals.
+  breakpoints, call stacks and locals on Android or an iOS simulator.
 
 ## How it works
 
@@ -64,56 +69,118 @@ Check the [requirements](#requirements) for your platform before installing.
 - [Android SDK](https://developer.android.com/studio) (adb) for Android support
 - Xcode and its command-line tools on macOS for iOS support
 - [idb](https://github.com/facebook/idb) for iOS UI inspection and interaction
-- JDK 17+ for optional [Android runtime debugging](docs/tools/debugger.md)
+- JDK 17+ for optional [Android runtime debugging](docs/tools/debugger.md); Xcode’s Swift-enabled LLDB/Python for optional iOS simulator debugging
 
 ## Agent plugin
 
-The preferred setup for supported agent clients is the
-[agent plugin](agent-plugin/README.md). It installs the MCP server configuration
-and usage skill together. Choose your client below.
+The plugin installs the MCP server configuration and the `mobile-debug-mcp` usage
+skill together. These are GitHub/local installation routes; they do not require
+approval from a client's public curated marketplace.
 
 <details>
 
-<summary>Codex plugin</summary>
+<summary>Codex</summary>
 
-Install the plugin from this repository's marketplace:
+In a terminal with a current Codex CLI:
 
 ```bash
-codex plugin marketplace add clivejefferies/mobile-debug-tools
+codex plugin marketplace add clivejefferies/mobile-debug-tools --ref main
 codex plugin add mobile-debug-tools@mobile-debug-tools
+codex plugin list
+```
+
+Start a new chat/session and confirm the plugin is enabled and its skill and MCP
+tools are available. These commands use the repository's marketplace, named
+`mobile-debug-tools`, not a public directory listing. See the
+[official packaging instructions](https://developers.openai.com/plugins/build/plugins).
+
+</details>
+
+<details>
+
+<summary>Claude Code</summary>
+
+Run these shell commands (not slash commands inside a chat):
+
+```bash
+claude plugin marketplace add clivejefferies/mobile-debug-tools --scope user
+claude plugin install mobile-debug-tools@mobile-debug-tools --scope user
+claude plugin list
 ```
 
+Restart the session after installation. In an interactive Claude Code chat, the
+corresponding commands start with `/plugin` instead of `claude plugin`. See
+[Claude Code's installation guide](https://code.claude.com/docs/en/discover-plugins).
+
 </details>
 
 <details>
 
-<summary>Claude Code plugin</summary>
+<summary>Cursor</summary>
 
-Install the plugin from this repository's marketplace:
+For local installation, clone this repository and run these commands from its
+root in a macOS/Linux shell:
 
 ```bash
-claude plugin marketplace add clivejefferies/mobile-debug-tools
-claude plugin install mobile-debug-tools@mobile-debug-tools
+git clone https://github.com/clivejefferies/mobile-debug-tools.git
+cd mobile-debug-tools
+cursor_plugin_dir="$HOME/.cursor/plugins/local/mobile-debug-tools"
+if [ -e "$cursor_plugin_dir" ]; then
+  echo "Move the existing plugin directory aside before copying the new package."
+else
+  mkdir -p "$(dirname "$cursor_plugin_dir")"
+  cp -R agent-plugin/cursor "$cursor_plugin_dir"
+fi
 ```
 
+On Windows, copy the contents of `agent-plugin/cursor` into a new
+`~/.cursor/plugins/local/mobile-debug-tools` folder, including `.cursor-plugin`.
+Use this generated Cursor-native package, not the portable parent: Cursor does
+not expand `${PLUGIN_DATA}` in portable `mcp.json`. Do not symlink to the checkout.
+
+Run **Developer: Reload Window**, open **Customize**, and confirm the skill and
+MCP server are loaded. For Teams/Enterprise distribution, import this repository
+under **Dashboard → Plugins & MCPs → Team Marketplaces**; its
+[Cursor catalog](.cursor-plugin/marketplace.json) selects the native package.
+Members install from Customize. See [Cursor's plugin guide](https://cursor.com/docs/plugins).
+
 </details>
 
 <details>
 
-<summary>Cursor plugin</summary>
+<summary>Antigravity</summary>
+
+Install the [Antigravity CLI](https://antigravity.google/docs/getting-started?tab=cli),
+then clone this GitHub repository and export its plugin:
 
-The repository includes a [Cursor marketplace](.cursor-plugin/marketplace.json).
-Teams and Enterprise admins can import the repository in Dashboard → Plugins & MCPs → Team
-Marketplaces. To test it locally, copy [agent-plugin](agent-plugin/) into
-`~/.cursor/plugins/local/mobile-debug-tools`, then reload Cursor.
+```bash
+git clone https://github.com/clivejefferies/mobile-debug-tools.git
+cd mobile-debug-tools
+npm run package:antigravity -- "$PWD/antigravity-dist"
+agy plugin validate --strict "$PWD/antigravity-dist"
+agy plugin install "$PWD/antigravity-dist"
+agy plugin list --json
+```
+
+No `npm install` is needed for the export script. Choose a new output directory;
+the exporter refuses to overwrite an existing one. Check the installed entry has
+one skill (`mobile-debug-mcp`) and one MCP server (`mobile-debug-mcp`), then start
+a new session and approve the specific MCP calls you intend to use.
+
+The Antigravity-only export avoids strict-validation warnings from the other
+clients' compatibility files. It uses `mcp_config.json` and the same pinned npm
+server and shared skill. GitHub/local installation does not require the
+Antigravity Marketplace interest form. See [Google's plugin guide](https://antigravity.google/docs/build-plugins).
 
 </details>
 
-Start a new chat or session after installation so the client loads the skill
-and MCP tools. Each plugin launches the published npm package locally and needs
-Node.js 22 or newer and the platform toolchains for your device. If you also
-registered the MCP server directly, disable that registration to avoid
-duplicate tools.
+Each client needs Node.js 22 or newer, `npx` on its PATH, npm registry access on
+first launch, and the platform toolchains for your device. After installation,
+ask the agent to list devices, select an explicit emulator/device, and inspect
+its screen. An installed component list alone does not prove a working device
+connection. Disable any separate manual registration of this MCP server in the
+same client to avoid duplicate tools. If a plugin command is unavailable, update
+the client; the [direct MCP configuration](#mcp-configuration) works independently.
 
 ## MCP configuration
 
@@ -235,3 +302,8 @@ Android debugger errors include bounded, sanitized failure classifications and r
 ## License
 
 [Apache-2.0](LICENSE)
+
+Launch and interaction results distinguish dispatch from timestamped
+[device readiness evidence](docs/tools/observe.md#device-readiness-evidence).
+Readiness waits account for observed sleeping/locked device blockers. Unknown or
+unsupported signals are explicit, and no automatic unlock is performed.

package/agent-plugin/.antigravity-plugin/README.md

@@ -0,0 +1,48 @@
+# Mobile Debug Tools for Antigravity
+
+Inspect and interact with Android and iOS apps using a local MCP server and the
+bundled `mobile-debug-mcp` usage skill. Capture screenshots, logs and UI trees;
+verify interactions with explicit evidence. Android additionally supports optional
+runtime debugging and bounded Perfetto system traces. iOS runtime debugging and
+system traces are not supported.
+
+## Prerequisites
+
+- Node.js 22 or newer, with `npx` on PATH and npm registry access on first launch.
+- Android SDK/platform-tools and an authorized device or running emulator for Android.
+- macOS and the applicable Xcode/idb tooling for iOS.
+- Host JDK 17+ and a debuggable Android app for optional runtime debugging.
+
+The server runs locally through `npx`; its exact version is pinned in
+`mcp_config.json`. The plugin uses the client-managed `${PLUGIN_DATA}` directory as its working directory.
+No plugin-specific account, API key, OAuth sign-in or hosted backend is required.
+
+## Install and use
+
+Install the extracted plugin directory with `agy plugin install /path/to/mobile-debug-tools`.
+Run `agy plugin list --json` and confirm one skill (`mobile-debug-mcp`) and one
+MCP server (`mobile-debug-mcp`) are discovered. Start a new session. Disable a
+separate manual registration of the same MCP server to avoid duplicate tools.
+
+Example prompts:
+
+- Check my mobile debugging environment and connected devices.
+- Inspect the current screen of my mobile app.
+- Help me reproduce and diagnose a bug in my mobile app.
+
+For a first check, select an explicit emulator/device, inspect its current screen,
+and verify a harmless interaction using fresh UI evidence. Readiness is a probe;
+a dispatched action alone does not establish an app outcome.
+
+## Access and support
+
+Tools can read device screens, logs and shallow debugger locals; they can also
+interact with apps and manage their lifecycle. These may contain private data.
+Use only devices and apps you intend to inspect. Build/install/reset operations
+have their own effects and should be requested explicitly. Trace contents and
+artifacts stay local; this plugin adds no automatic upload service.
+
+Source and setup: https://github.com/clivejefferies/mobile-debug-tools
+Tool reference: https://github.com/clivejefferies/mobile-debug-tools/blob/main/docs/tools/TOOLS.md
+Support: https://github.com/clivejefferies/mobile-debug-tools/issues
+License: Apache-2.0. Publisher attribution: mobile-debug-tools contributors.

package/agent-plugin/.antigravity-plugin/plugin.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://antigravity.google/schemas/v1/plugin.json",
+  "name": "mobile-debug-tools",
+  "version": "0.0.7",
+  "description": "Mobile app debugging tools and usage guidance for Android and iOS agents.",
+  "author": {
+    "name": "mobile-debug-tools contributors"
+  },
+  "repository": "https://github.com/clivejefferies/mobile-debug-tools",
+  "license": "Apache-2.0",
+  "displayName": "Mobile Debug Tools",
+  "logo": "assets/mobile-debug-tools.svg",
+  "suggestedPrompts": [
+    "Check my mobile debugging environment and connected devices.",
+    "Inspect the current screen of my mobile app.",
+    "Help me reproduce and diagnose a bug in my mobile app."
+  ]
+}

package/agent-plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "mobile-debug-tools",
-  "version": "0.0.4",
+  "version": "0.0.7",
   "description": "Mobile app debugging tools and usage guidance for Android and iOS agents.",
   "author": {
     "name": "mobile-debug-tools contributors"
@@ -12,7 +12,7 @@
       "command": "npx",
       "args": [
         "--yes",
-        "mobile-debug-mcp@0.35.0",
+        "mobile-debug-mcp@0.37.0",
         "server"
       ]
     }

package/agent-plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "mobile-debug-tools",
-  "version": "0.0.4",
+  "version": "0.0.7",
   "description": "Mobile app debugging tools and usage guidance for Android and iOS agents.",
   "repository": "https://github.com/clivejefferies/mobile-debug-tools",
   "license": "Apache-2.0",

package/agent-plugin/.cursor-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "mobile-debug-tools",
-  "version": "0.0.4",
+  "version": "0.0.7",
   "description": "Mobile app debugging tools and usage guidance for Android and iOS agents.",
   "author": {
     "name": "mobile-debug-tools contributors"
@@ -14,7 +14,7 @@
       "command": "npx",
       "args": [
         "--yes",
-        "mobile-debug-mcp@0.35.0",
+        "mobile-debug-mcp@0.37.0",
         "server"
       ],
       "cwd": "${CURSOR_PLUGIN_ROOT}"

package/agent-plugin/.mcp.json

@@ -5,7 +5,7 @@
       "command": "npx",
       "args": [
         "--yes",
-        "mobile-debug-mcp@0.35.0",
+        "mobile-debug-mcp@0.37.0",
         "server"
       ],
       "cwd": "${PLUGIN_DATA}"

package/agent-plugin/README.md

@@ -4,22 +4,24 @@
 
 Use the [client installation instructions](../README.md#agent-plugin) to install
 the plugin. It supports clients with
-both skills and stdio MCP servers. It provides the mobile-debug MCP
+both skills and stdio MCP servers: Codex, Claude Code, Cursor and Antigravity. It provides the mobile-debug MCP
 usage skill and launches the published `mobile-debug-mcp` npm package. The
 plugin requires Node.js 22 or newer, `npx`, and the platform toolchains needed
 for the devices you want to use. The first launch may need npm registry access.
-The MCP process starts in the client-managed plugin data directory so npm does
-not resolve the source checkout as a local package when installed from this repo.
+Codex and Antigravity run the MCP process in a client-managed plugin data
+directory. Cursor uses its plugin root through `${CURSOR_PLUGIN_ROOT}`; Claude
+Code chooses its own process working directory.
 
 ## Versions and maintenance
 
 The server is pinned to the published npm version in `mcp.json`. The plugin's
 `plugin.json` version advances independently for guidance-only releases; do not
 change the server pin to an unpublished npm version. The
-[usage skill](skills/mobile-debug-mcp/SKILL.md) is shared by all three clients. Run
+[usage skill](skills/mobile-debug-mcp/SKILL.md) is the canonical source shared by all four clients. Run
 `npm run sync:agent-plugin` after updating the plugin metadata or server pin to
-refresh the thin Codex, Claude Code, and Cursor manifests in this directory.
-The three marketplaces all point here and share one skill.
+refresh all client manifests and the generated Cursor-native package in `cursor/`.
+The Codex and Claude catalogs point to this portable directory; the Cursor
+catalog points to `cursor/` because Cursor cannot expand `${PLUGIN_DATA}`.
 The packaged directory uses the skill's declared name, `mobile-debug-mcp`, as
 required by Agent Skills. `npm run check:agent-plugin` checks the packaged
 copies and configuration.
@@ -32,7 +34,7 @@ agent through device selection, observation, interaction and verification.
 The usage skill prefers screenshots for routine visual checks and reserves
 hierarchy reads for semantic selection and structured assertions. Assertion
 timeouts must cover a fresh tree read as well as the expected app transition.
-It also covers optional Android runtime debugging: capability checks, explicit
+It also covers optional Android and supported iOS simulator runtime debugging: capability checks, explicit
 process attach, source stops, bounded inspection, stepping and owned cleanup.
 Debugger guidance applies only when the connected server exposes those tools;
 updating the skill does not update the pinned server or installed plugin.
@@ -40,4 +42,31 @@ updating the skill does not update the pinned server or installed plugin.
 If you already configured the MCP server directly in your agent client, disable
 that separate registration when enabling this plugin to avoid duplicate tools.
 The direct npm installation remains available without this plugin. See the
-[repository README](../README.md#environment-setup) for platform toolchain setup and `get_system_status` guidance.
+[repository requirements](../README.md#requirements) for platform toolchain setup and `get_system_status` guidance.
+
+## Antigravity distribution
+
+Run `npm run package:antigravity -- /absolute/path/to/a-new-directory` from the
+repository root. The exporter uses only Node built-ins; it does not require a
+local dependency install. It creates a standalone directory with native
+`plugin.json`, `mcp_config.json`, README, license, logo and the canonical skill.
+Validate that export with `agy plugin validate --strict /absolute/path/to/export`
+and install it with `agy plugin install /absolute/path/to/export`.
+
+The multi-client source intentionally contains files that Antigravity ignores;
+strict validation belongs on the clean export, not on this mixed source folder.
+Other clients' manifests are excluded from the export. The export is suitable
+for a GitHub download or local installation without curated Marketplace approval.
+Antigravity's Marketplace form is an optional, separate distribution route.
+
+## Installation verification
+
+The main README links each vendor's current installation documentation. Codex
+and Claude Code's shell command syntax was checked against installed CLI help;
+Claude's plugin and catalog validate with its native validator. Cursor's native
+layout follows its documented local-plugin and variable rules; installation in
+Cursor has not been exercised on this machine. Antigravity strict validation and
+local component discovery have been exercised. Agent-level MCP permissions must
+still be approved by the user; component discovery is not a completed tool call.
+See the [installation verification record](../docs/agent-plugin-installation-verification.md)
+for tested versions, device evidence and unrun host checks.

package/agent-plugin/cursor/.cursor-plugin/plugin.json

@@ -0,0 +1,23 @@
+{
+  "name": "mobile-debug-tools",
+  "version": "0.0.7",
+  "description": "Mobile app debugging tools and usage guidance for Android and iOS agents.",
+  "author": {
+    "name": "mobile-debug-tools contributors"
+  },
+  "repository": "https://github.com/clivejefferies/mobile-debug-tools",
+  "license": "Apache-2.0",
+  "skills": "./skills/",
+  "mcpServers": {
+    "mobile-debug-mcp": {
+      "type": "stdio",
+      "command": "npx",
+      "args": [
+        "--yes",
+        "mobile-debug-mcp@0.37.0",
+        "server"
+      ],
+      "cwd": "${CURSOR_PLUGIN_ROOT}"
+    }
+  }
+}

package/agent-plugin/cursor/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/agent-plugin/cursor/README.md

@@ -0,0 +1,9 @@
+# Mobile Debug Tools for Cursor
+
+Generated by `npm run sync:agent-plugin`; edit the canonical plugin source.
+
+Copy the contents of this directory into `~/.cursor/plugins/local/mobile-debug-tools`,
+then run Developer: Reload Window and check Customize for the skill and MCP server.
+Do not copy the portable parent plugin: its `${PLUGIN_DATA}` variable is not expanded by Cursor.
+
+Setup and support: https://github.com/clivejefferies/mobile-debug-tools