argent-metro-debugger

Debug React Native and Chromium runtimes over CDP via Metro-connected debugger tools.

Updated Aug 29, 2026
One-click install
npx skills add https://github.com/Seyamalam/pstu_final --skill argent-metro-debugger-seyamalam
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: argent-metro-debugger
Source: https://github.com/Seyamalam/pstu_final/tree/main/.agents/skills/argent-metro-debugger
Command: npx skills add https://github.com/Seyamalam/pstu_final --skill argent-metro-debugger-seyamalam

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? It removes the guesswork from debugging a running JavaScript runtime by giving you a structured way to connect to Metro's CDP endpoint, diagnose connection failures, inspect React component trees, read console logs, and evaluate JavaScript inside the live app. ## Core Features & Use Cases - Connection & Diagnostics: Connect to the JS runtime via debugger-connect and diagnose failures with debugger-status, which returns coded reasons (metro_not_running, no_app_connected, device_mismatch, stale_connection) plus actionable guidance instead of raw errors. - Component Inspection: Dump the full React fiber tree with debugger-component-tree or trace a tapped element to its source file and line with debugger-inspect-element, including source-map symbolication. - Console Log Analysis: Use debugger-log-registry to get log summaries and clusters, then grep the flat log file with anchored entry IDs instead of reading logs inline. - Multi-Platform Support: Works with React Native on iOS, Android (via adb reverse), and Vega, plus a subset of tools for Chromium/CDP apps such as Electron. - Use Case: Your Android emulator app shows a blank screen. Run debugger-status to find no_app_connected, relaunch with restart-app, reconnect, then grep the log registry for the red-screen error and inspect the offending component's source location. ## Quick Start Connect to the running React Native app through Metro and show me the current console error logs and component tree.

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 connected to Metro?

Call debugger-status first to verify Metro is running and an app target is connected, then use debugger-connect to attach to the runtime's CDP session. From there you can inspect the component tree, read console logs, or evaluate JavaScript in the app.

How do I read React Native console logs from Metro?

Use debugger-log-registry to get a summary with counts, clusters, and the flat log file path, then grep that file with scoped patterns instead of reading it directly. Each line has an anchor ID, timestamp, level, source location, and message.

Why does the debugger say no app is connected to Metro?

The no_app_connected reason means Metro is running but no React Native app has attached as a CDP target. Relaunch the app with restart-app, wait for the bundle to load, then retry debugger-status once.

Can I use CDP debugging with an Android emulator or device?

Yes, but Android devices cannot resolve the host's localhost by default. Run adb reverse tcp:8081 tcp:8081 for the device serial first so the app can reach Metro, then all debugger tools work unchanged.

Why does inspect-element return null source locations?

Source resolution fails when the Babel config does not inject JSX source information, common with the automatic JSX transform in Expo SDK 50+ and RN 0.73+. Add @babel/plugin-transform-react-jsx-source to babel.config.js and restart Metro with a cleared cache.

Which debugger tools work on Chromium or Electron apps?

Only debugger-connect, debugger-status, debugger-evaluate, debugger-log-registry, and the network log viewers work on Chromium CDP targets. Component tree, inspect-element, reload-metro, and profiler tools are React Native only and are rejected at the capability gate.