# install-poki

The install-poki Claude Code skill installs Poki on an iPhone from a Mac and updates an existing app. It runs on an install or update request, or when the phone's own update gets stuck.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 1754 repo stars
- Author: JosssphZhou
- License: AGPL-3.0-only · policy=link-only · description only; the file stays with the author
- Source: https://github.com/JosssphZhou/poki/tree/HEAD/skills/install-poki/SKILL.md
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/install-poki

## What it does

The skill runs Poki's checkout installer and relays its prompts during iPhone setup. For an update, it checks the app's existing signing identity before installing; a first-time setup needs Wi-Fi on the phone. The agent also reports the installer's checks.

Requirements include a Mac on macOS 14 or newer, Node.js 24 or newer, an iPhone on iOS 18 or newer, a USB data cable, an Apple Account, and a VPN app that routes `10.7.0.1` back to the iPhone. The checkout must contain `bin/install-iphone.mjs`. Without Node.js 24, use the alternate installation method; on iOS 18–26, the XCTest control path needs UI Automation and has not been tested on physical iPhones running those versions.

Transferring a model API key from the Mac keychain is optional and defaults to no. Poki uses its own model-provider account; the coding agent's subscription does not connect that account.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add JosssphZhou/poki --skill install-poki -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/install-poki/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/install-poki/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add JosssphZhou/poki --skill install-poki -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/install-poki/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add JosssphZhou/poki --skill install-poki -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/install-poki/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install JosssphZhou/poki skills/install-poki
```

2. **Manually: put the files in place**
- File: `.github/skills/install-poki/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add JosssphZhou/poki --skill install-poki -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/JosssphZhou/poki --path skills/install-poki
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/install-poki/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/JosssphZhou/poki/tree/HEAD/skills/install-poki/SKILL.md

## When to use it
- install Poki on an iPhone from a Mac
- update an installed Poki app from a computer
- resume an update that stalls on the iPhone
- check installation results from the installer events

## Example prompts
- Install Poki on my iPhone from this Mac.
- Update Poki on the connected iPhone.
- Poki's iPhone update is stuck; install it from the Mac.

## Similar
- [argent-ios-device-setup](https://affpapa.org/en/nevibecode/skills/argent-ios-device-setup.md) — skill · 17100 installs
- [argent-ios-device-interact](https://affpapa.org/en/nevibecode/skills/argent-ios-device-interact.md) — skill · 17100 installs
- [ios-device-automation](https://affpapa.org/en/nevibecode/skills/ios-device-automation.md) — skill · 3500 installs
- [Handsy AI](https://affpapa.org/en/nevibecode/mcp/handsy-ai.md) — MCP server · ★ 5197 repo stars
- [Zeptap](https://affpapa.org/en/nevibecode/mcp/zeptap.md) — MCP server · ★ 10 repo stars

From the same set: [josssphzhou/poki](https://affpapa.org/en/nevibecode/by/josssphzhou/poki.md) — 5 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
