Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tapkit.ai/llms.txt

Use this file to discover all available pages before exploring further.

The TapKit Mac app is the host that connects physical iPhones to your TapKit account, making them available to any integration — Claude, Codex, the API, or any MCP client. No Mac app running, no phone access.
TapKit Mac app showing connected iPhone with gestures panel and agent sessions

​
Status bar

Five indicators at the top of the sidebar show system status at a glance. Green means connected, yellow means connecting, and red means disconnected or off.
Status bar showing Switch, Server, Phone, Screen, and Stream indicators
IndicatorWhat it means
SwitchWhether Switch Control is connected and running. Red = off, yellow = connecting, green = on.
ServerWhether you have a live connection to the TapKit server. Green = logged in and connected. Red = signed out or connection issues.
PhoneWhether your iPhone is detected as connected.
ScreenWhether the Mac is receiving the screen stream from your phone. Red if the phone is locked or something is interrupting the stream.
StreamWhether someone else on your team is viewing the live stream on the web app. Green = someone is watching, red = no active viewers.

​
Gestures & Device Controls

Below the device list, you can switch between Gestures and Device tabs. Gestures shows touch gestures (tap, swipe, pinch, etc.) and Device shows device controls (home, lock, volume, etc.). You can trigger these manually by clicking them — useful for testing or quick one-off actions.
Gestures tab showing tap, double tap, flick, pan, drag, and pinchDevice tab showing home, lock, siri, spotlight, volume, and more

​
Switch Control

At the bottom left, the Switch Control section shows the connection status. When off, you can turn it on or open the Switch Control menu. When on, you get three buttons for interacting with Apple’s Switch Control directly — Next iterates through items, Select selects the current item, and Stop stops scanning. These are there as a convenience in case Switch Control gets stuck or you want to control it manually.
Switch Control off with Turn On and Open Menu buttonsSwitch Control on with Next, Select, Stop buttons and Turn Off

​
Phone view (center)

The center panel shows a live feed of the selected phone’s screen. During an active task, you’ll see the agent’s actions happen in real-time — taps, swipes, typing, and navigation. The screen updates continuously so you always know what the agent is doing and can intervene if needed.

​
Agent chat (right)

The right panel is a built-in agent interface. Type a natural language prompt — like “Open Settings and turn on Dark Mode” — and the agent will execute it on the phone. This is the fastest way to test TapKit without setting up any external integrations.

​
Settings

The settings window has four tabs: General, Phones, Account, and Script Logs.
View the status of your macOS permissions (Accessibility, Camera, Automation) and grant any that are missing. Run Setup Again takes you back to the beginning of the setup flow if you need to reconfigure or set up a new phone. Show Advanced Settings enables verbose AppleScript output and the Script Logs tab for troubleshooting.
General settings showing permissions, setup, and advanced options
Switch between multiple connected phones, set the active phone, and configure passcodes. Your phone’s passcode is used to unlock it — TapKit stores it locally in your Mac’s keychain and never uploads it to the server.
Phones settings showing active phone, connected phones, and passcode configuration
View your sign-in status, sign out, and manage your subscription and billing.
Account settings showing sign-in status, billing, and manage subscription
View verbose AppleScript logs for troubleshooting. Only visible when Show Advanced Settings is enabled in the General tab.