aleqsio

aleqsio / react-native-worktree

Public

Metro port switcher with mutex for multi-agent React Native development

17
0
100% credibility
Found Mar 04, 2026 at 17 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
JavaScript
AI Summary

A coordination tool for teams developing mobile apps, allowing multiple people to share test simulators by taking turns without conflicts.

How It Works

1
🔍 Hear about the teamwork helper

You learn about a simple tool that lets friends build a mobile app together without bumping into each other's work on test phones.

2
📥 Add it to your setup

You easily install the tool on your computer so your team can start sharing the test devices.

3
🏗️ Make your own space

You create a private area for your feature or bug fix, keeping everything organized.

4
🚀 Start your preview

You launch a test version of your changes that runs quietly in the background, ready when you are.

5
📱 Request the test phone

You ask to borrow the phone simulator or emulator; if busy, it patiently waits its turn.

6
✨ Watch it switch to you

The test phone flips to show your work live, feeling magical as it restarts with your updates.

7
✅ Test and release

You play around, take pictures of the screen, then free it up for the next teammate.

🎉 Team builds faster

Everyone adds their magic smoothly, and your app comes alive better than ever.

Sign up to see the full architecture

6 more

Sign Up Free

Star Growth

See how this repo grew from 17 to 17 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is react-native-worktree?

This JavaScript CLI tool lets multiple developers or AI agents collaborate on a React Native or Expo app using git worktrees, each running its own Metro bundler on a unique port. It solves the chaos of shared iOS simulators and Android emulators by queuing access via per-platform locks—you add a worktree, switch to grab the device, test your changes, then release for the next person. No app modifications needed; it auto-detects bundle IDs and handles port assignment, with commands like `add`, `switch --platform ios`, `release`, `status`, and `list`.

Why is it gaining traction?

It stands out by automating Metro bundler port switching for github metro bundler setups, with cooperative locks that detect stale sessions and allow independent iOS/Android access—perfect for metro android github or metro config github workflows. Developers notice seamless queuing without proxies or native modules, plus port reclamation from dead servers. The hook is AI agent integration via installable skills, enabling parallel feature branches in metro porta-style development without device fights.

Who should use this?

AI-driven teams building React Native apps, where multiple agents like Claude tackle features in separate worktrees and need queued simulator access. Solo devs juggling branches on metro portugal or metro porto projects via git worktrees. Any group doing multi-agent development on shared emulators, tired of manual port tweaks or emulator resets.

Verdict

Worth trying for niche React Native teams experimenting with AI parallelism—solid docs and MIT license make it easy to adopt despite 17 stars and 1.0% credibility score signaling early maturity. Test in a side project first; lacks broad adoption or extensive tests, but fills a real gap in metro unlocker github scenarios.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.