> ## 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.

# Codex (CLI)

> Control iPhones from the Codex CLI

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

<Note>
  This guide assumes you already have the Codex CLI installed. If you do not, follow OpenAI's [Codex CLI setup guide](https://developers.openai.com/codex/cli) first.
</Note>

**1. Add the TapKit marketplace** from your terminal:

```bash theme={null}
codex plugin marketplace add jootsing-research/tapkit-plugins-codex
```

**2. Install the plugin**:

```bash theme={null}
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:

```bash theme={null}
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

## Links

* [TapKit Codex plugin on GitHub](https://github.com/Jootsing-Research/tapkit-plugins-codex)
* [Codex plugin docs](https://developers.openai.com/codex/plugins)
* [API Reference](/api-reference/introduction)