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 plugin for Codex gives the agent iPhone control in the desktop app. It installs an MCP server connection and a skill file that teaches Codex how to use the tools effectively.
This guide assumes you already have the Codex CLI installed. If you do not, follow OpenAI’s Codex CLI setup guide first.

​
Step 1: Add the TapKit marketplace

Run this command in your terminal: 
codex plugin marketplace add jootsing-research/tapkit-plugins-codex
If the Codex app is already open, restart it so the new marketplace appears.

​
Step 2: Open Plugins

In the Codex app, click Plugins in the left sidebar.
Codex app sidebar with Plugins selected

​
Step 3: Select the TapKit marketplace

On the Plugins page, open the marketplace dropdown and select Tap Kit Plugins.
Codex plugins page marketplace dropdown showing Tap Kit Plugins

​
Step 4: Install the TapKit plugin

Find Tap Kit under Productivity, click the + button, then click Install Tap Kit in the popup.
Codex plugins page showing Tap Kit with plus buttonInstall Tap Kit popup with Install Tap Kit button

​
Step 5: Confirm TapKit is installed

After installation, TapKit shows a checkmark in the plugin list.
Codex plugins page showing Tap Kit installed with checkmark

​
Step 6: Authenticate

Once the plugin is loaded, the TapKit MCP server will prompt you to sign in via your browser.

​
Verify it works

Take a screenshot of my phone
If a phone is connected via the Mac app, you’ll see the screenshot.

​
Upgrade

Refresh the TapKit marketplace when a new plugin version is available: 
codex plugin marketplace upgrade tapkit-plugins
tapkit-plugins is the Codex marketplace name from the marketplace metadata.

​
What’s in the plugin

The TapKit plugin bundles:
  • MCP server config — connects Codex to TapKit’s hosted MCP endpoint
  • Skills — teaches Codex how to use the coordinate system, screenshot loop, and gesture types