Node.js wrapper around Apple's devicectl tool, the command-line utility to control iOS devices. devicectl is run as a sub-command of xcrun and requires Xcode 15+ and iOS 17+.
Install through npm.
npm install node-devicectlThe module exports a single class Devicectl. This class contains methods which wrap various devicectl subcommands.
Any devicectl subcommand could be called via execute method,
which accepts the subcommand itself as the first argument and the set of options. For example:
import { Devicectl } from 'node-devicectl';
const devicectl = new Devicectl('device-udid');
const processes = await devicectl.listProcesses();
await devicectl.launchApp('com.example.app', {
env: { DEBUG: '1' },
terminateExisting: true
});- Xcode 15+
- iOS 17+
- Node.js 20.19.0+ || 22.12.0+ || 24.0.0+
Apache-2.0
