@buoy-gg/mcp 7.0.3 → 7.0.5

package/README.md

@@ -18,17 +18,34 @@ One command, non-destructive:
 
 The config it writes launches the server via `npx -y @buoy-gg/mcp@latest`, so every editor restart re-resolves the newest published version — you never get pinned to a stale copy. Restart your editor, open your app with Buoy running, and start with `list_devices`.
 
+### Corporate / private npm registries
+
+If your machine's `.npmrc` points npm at a private registry that isn't reachable (a common setup on work laptops, e.g. off-VPN), `npx @latest` would hang trying to download the package on every editor launch — so `init` probes that registry first and, when it's unreachable, automatically installs a **pinned local copy** (from public npm) and writes a `node <path>` config instead. That takes the network off the startup path entirely.
+
+You can also force it:
+
+```bash
+npx -y @buoy-gg/mcp@latest init --local                 # always install locally, no network on startup
+npx -y @buoy-gg/mcp@latest init --npx                    # always use the auto-updating npx entry
+npx -y @buoy-gg/mcp@latest init --registry <url>         # registry the local install pulls from
+```
+
+To update a local install later, just re-run `init`.
+
 ## What your agent can do
 
 **Read the runtime**
 
 - `get_events` — one timeline across every tool: network, state changes, renders, routes, storage writes — in token-friendly summaries
 - `get_console` — read the app's console logs, even from a release build
+- `get_network_requests` — HTTP requests *with their ids* (which `get_events` omits), marked 📌 pinned / 🔖 saved; `flagged:"any"` reads the requests you kept
+- `network_action` — pin or save a request. Pinned requests survive Clear, the history cap and restarts, so it doubles as a handoff: pin the broken call and ask your agent about "the pinned request", or let it pin what it wants you to see
 
 **Drive the UI**
 
 - `describe_screen` — walks the live React tree into an accessibility-style element list with labels, testIDs, control values, and tap points
 - `tap_element` — presses real JS handlers: tap a button, flip a switch, move a slider, type into a field. No screenshots, no pixel coordinates, works on physical devices. Off-screen targets are scrolled into view first.
+- `reload_app` — restarts the JS bundle (Expo Go, dev client, or RN CLI) and waits for the app to come back, for changes Fast Refresh missed or a clean-slate startup. Ships with `@buoy-gg/core` — no extra package needed.
 
 **Change state**