argent-react-native-profiler

Installation
SKILL.md

This skill is complementary to argent-react-native-optimization, not a replacement for it.

Physical iPhone: not supported; react-profiler-* reject kind: "device". Profile on a simulator.

For react-native-macos, start Metro and use argent-macos-app-interact to launch a Debug build of version 0.76 or later with Hermes. Pass the Mac app's device_id from list-devices and call react-profiler-start directly. Use the same ID and Metro port for the rest of the session. If Metro cannot find the runtime, make sure the app is running, wait for its bundle to load, and check the port (8081 by default). Retry with the same app ID, even if Metro lists other devices. If the retry fails, report the error.

1. Tools

React Profiler (Hermes / React commits)

  • react-profiler-start / react-profiler-stop: record CPU samples and React commits around an interaction.
  • react-profiler-analyze: turn the recording into a ranked report: hot commits with the JS functions that ran during each, and the file and line of each ranked component it finds in the project.
  • react-profiler-status: only after an interruption (debugger drop, Metro reload, pause, subagent handoff, any doubt), never otherwise. After a debugger drop, react-profiler-stop can no longer collect the run; check status before stopping or restarting.
  • react-profiler-fiber-tree: live component hierarchy, no session needed, for tracing a component's ancestry.
Installs
32.3K
GitHub Stars
3.2K
First Seen
Apr 28, 2026