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 your terminal. It installs an MCP server connection and a skill file that teaches Codex how to use the tools effectively.

Setup

This guide assumes you already have the Codex CLI installed. If you do not, follow OpenAI’s Codex CLI setup guide first.
1. Add the TapKit marketplace from your terminal:
codex plugin marketplace add jootsing-research/tapkit-plugins-codex
2. Install the plugin:
codex
/plugins
In the plugin directory, switch to the Tap Kit Plugins marketplace, open Tap Kit, and select Install plugin. 3. Authenticate — once the plugin is loaded, the TapKit MCP server will prompt you to sign in via your browser. 4. 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