TapKit’s phone setup follows a set once, use everywhere model. Set your active phone once, and every command after that uses it automatically — no --phone flag needed.
List connected phones
tapkit phones
# NAME ID SCREEN STATUS
# iPhone 15 Pro A1B2C3 1179x2556 connected
# iPhone 13 mini D4E5F6 1080x2340 connected
Set your active phone
Run tapkit phone set to get an interactive picker:
tapkit phone set
# ? Select a phone:
# > iPhone 15 Pro (A1B2C3) 1179x2556 connected
# iPhone 13 mini (D4E5F6) 1080x2340 connected
#
# Active phone set to iPhone 15 Pro (A1B2C3)
tapkit phone set "iPhone 15 Pro"
# Active phone set to iPhone 15 Pro (A1B2C3)
~/.tapkit/config.json. Every subsequent command uses this phone automatically.
Check active phone
tapkit phone
# ● iPhone 15 Pro (A1B2C3) 1179x2556 connected
Clear active phone
Single phone? If only one phone is connected, TapKit auto-selects it. You only need tapkit phone set when you have multiple devices.
Phone resolution order
TapKit determines which phone to use in this order:
--phone flag (highest priority)TAPKIT_PHONE_ID environment variablephone in ~/.tapkit/config.json- Auto-select if only one phone is connected
