ZeptapDocs
Commands

phones

List the iPhones paired with this Mac, whether each is ready to drive, and who holds it.

Usage

zeptap phones

zeptap list does the same.

Options

OptionDescription
--jsonPrint the phones as data in one JSON object

Details

  • One line per phone: its id, name, model, iOS version, whether it's the active phone, Bluetooth and USB status, whether it's ready (and why not), and its lease if one is held.
  • Pass an id or a name to other commands with -p, or set ZEPTAP_PHONE. Without either, commands act on the only paired phone, or the one active in Zeptap.
  • With no paired iPhone it fails and says so.

Examples

$ zeptap phones
2 iPhones:
id=A1B2 name="Test iPhone" model="iPhone 15" ios=18.1 active=true bluetooth=connected usb=plugged in ready=yes
id=C3D4 name="Spare" model="iPhone 13" ios=17.6 active=false bluetooth=not connected usb=plugged in ready=no (…)

MCP tool

list_phones.

On this page