argent-metro-debugger

Debug React Native apps via Metro CDP for UI, logs, and JavaScript.

Updated May 7, 2026
One-click install
npx skills add https://github.com/softwarebyze/Backgammon-Mastermind --skill argent-metro-debugger
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: argent-metro-debugger
Source: https://github.com/softwarebyze/Backgammon-Mastermind/tree/main/.agents/skills/argent-metro-debugger
Command: npx skills add https://github.com/softwarebyze/Backgammon-Mastermind --skill argent-metro-debugger

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you reliably diagnose and fix React Native runtime issues by letting you connect to Metro and inspect the app’s UI, logs, and JavaScript behavior in context.

Core Features & Use Cases

  • Connect to Metro CDP for an app-specific debugging session: Establish a Metro CDP connection and target a specific simulator/device using the returned logical device id.
  • Inspect UI and trace components to source: Retrieve a full React component tree and inspect a visible element to map it back to component hierarchy and source file locations when available.
  • Diagnose console output with log registry + targeted search: Summarize log clusters and then guide you to grep/read relevant log entries from the underlying flat log file.
  • Evaluate JavaScript in the app runtime: Run expressions to validate assumptions about state, props, or runtime behavior without redeploying.

Quick Start

Run a diagnostic connection by calling the debugger-status tool after your Metro dev server is running and your React Native app is connected to Metro.

Frequently Asked Questions about argent-metro-debugger

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug a React Native app through Metro CDP?

React Native Metro debugging requires a running Metro server and a connected app to establish a CDP target. You use the returned logical device id to target specific simulator or physical devices for debugging, network, and profiler calls.

How do I inspect React Native UI components and trace them to source files?

React Native component inspection retrieves the full React component tree from the connected app. You can inspect a visible element to map it back to the component hierarchy and source file locations when source maps are available.

Can I evaluate JavaScript expressions in a React Native app runtime without redeploying?

You can evaluate JavaScript in the React Native runtime through the Metro CDP connection to validate assumptions about state, props, or runtime behavior. This allows you to test expressions on-device or in the simulator without redeploying the app.

What's the best way to analyze React Native console logs and diagnose runtime issues?

React Native log analysis through Metro CDP summarizes log clusters and guides you to grep or read relevant log entries from the underlying flat log file. This helps diagnose console output, UI rendering issues, and runtime logic errors.

Does React Native Metro debugging work with both iOS simulators and Android devices?

React Native Metro debugging supports iOS simulators and Android devices or emulators. You must target the correct device_id from the connected app when making debugger, network, and profiler calls to ensure diagnostics reach the right target.

What do I need to run diagnostics on a React Native app using Metro CDP?

To run React Native diagnostics via Metro CDP, you need a running Metro dev server and your React Native app connected to Metro. Call the debugger-status tool after setup to establish the debugging session and retrieve the device id.