The definitive tool for scriptable system control on rootless jailbreaks
T

The definitive tool for scriptable system control on rootless jailbreaks

The definitive tool for scriptable system control on rootless jailbreaks

80 stars
N/A forks
N/A contributors

README

Project documentation from GitHub

RemoteCompanion: Scriptable System Control for Rootless Jailbreaks

If you've ever tinkered with a jailbroken iOS device, you know the power it unlocks. But with the rise of rootless jailbreaks, some of the old ways of automating and controlling the system from a computer became a bit more complicated. That's where RemoteCompanion comes in. It's a tool that bridges that gap, giving you a clean, scriptable way to control a rootless-jailbroken device from your desktop, no convoluted SSH port forwarding required.

Think of it as a dedicated remote control for your jailbroken iPhone or iPad, built for the modern era of iOS hacking. It solves a real, practical problem for developers and power users who want to automate tasks or build tools that interact with the system.

What It Does

RemoteCompanion is a client-server application. You run a small server (a "tweak") on your jailbroken iOS device. This server listens for commands. On your computer (macOS, Linux, Windows), you run the client. The client can then send a variety of commands to the device over your local network.

These commands let you perform actions like rebooting the device, respringing the SpringBoard, launching apps, simulating touch events, and even triggering Activator events. The key is that it provides a structured, programmatic way to do all this from your computer's terminal or your own scripts.

Why It's Cool

The clever part is in its design for the rootless environment. Instead of fighting the new sandboxing constraints, RemoteCompanion works within them. It uses the PosixSpawn API for process control and leverages standard iOS frameworks in a way that's compatible with rootless jailbreaks like Dopamine or palera1n-rootless.

For developers, the real win is the scriptability. You can now write a Python script on your laptop that, for example, launches a beta app on your tethered test device, simulates a series of taps to navigate to a specific screen, and then resprings—all automatically. It turns your device into a more integrated part of your development and testing workflow. It's also just a solid, focused tool that does one thing and does it well, without unnecessary bloat.

How to Try It

Getting started is straightforward. You'll need a device with a rootless jailbreak already installed.

  1. On your iOS device: Add the repository https://saihgupr.github.io/repo to your package manager (like Sileo or Zebra). Search for and install the "RemoteCompanion" package. This installs the server tweak.
  2. On your computer: Head to the RemoteCompanion GitHub repository. Download the latest release of the client binary for your operating system (macOS, Linux, or Windows) from the Releases page.
  3. Connect: Make sure your

Did you like this issue?

Join our weekly newsletter

Love discovering amazing projects?

Help us continue bringing you the best open-source discoveries every week.

Back to Projects
Last updated: Mar 21, 2026