#Installation

#Global install

npm install -g agent-device

#Without installing

npx agent-device open Settings --platform ios

#Requirements

• Node.js 22+
• Xcode for iOS simulator/device automation (simctl + devicectl)
• Android SDK / ADB for Android

#iOS physical device prerequisites

• Device is paired and visible in xcrun devicectl list devices.
• Developer Mode enabled on device.
• Signing configured in Xcode (Automatic Signing recommended), or use:
• AGENT_DEVICE_IOS_TEAM_ID
• AGENT_DEVICE_IOS_SIGNING_IDENTITY
• AGENT_DEVICE_IOS_PROVISIONING_PROFILE
• AGENT_DEVICE_IOS_BUNDLE_ID (optional runner bundle-id base override)
• Free Apple Developer (Personal Team) accounts can fail with "bundle identifier is not available" for generic IDs; set AGENT_DEVICE_IOS_BUNDLE_ID to a unique reverse-DNS value (for example com.yourname.agentdevice.runner).
• If device setup is slow, increase daemon timeout:
  • AGENT_DEVICE_DAEMON_TIMEOUT_MS=120000 (default is 90000)
• If daemon startup reports stale metadata, remove stale files and retry:
  • <state-dir>/daemon.json
  • <state-dir>/daemon.lock
  • default state dir is ~/.agent-device unless AGENT_DEVICE_STATE_DIR or --state-dir is set
• Optional remote tenancy/lease controls:
  • AGENT_DEVICE_MAX_SIMULATOR_LEASES=<n>
  • AGENT_DEVICE_LEASE_TTL_MS=<ms>
  • AGENT_DEVICE_LEASE_MIN_TTL_MS=<ms>
  • AGENT_DEVICE_LEASE_MAX_TTL_MS=<ms>