# terminal-phone

Скилл для Claude Code управляет симулятором iOS или подключённым iPhone через terminal-phone. Он устанавливает и запускает приложение, нажимает элементы интерфейса, делает снимки экрана и проверяет результаты.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 366 у репозитория
- Автор: govijr
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/govijr/terminal-phone/tree/HEAD/plugins/terminal-phone/skills/terminal-phone/SKILL.md
- Обновлён: 2026-11-09
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/terminal-phone

## Что делает

Скилл проводит приложение через экранные сценарии и проверяет, что действие сработало. Он может собрать проект Xcode, установить приложение и запустить его; для установки готовой сборки используют команду `terminal-phone install`. Симулятору нужен файл `.app`, собранный для симулятора, а iPhone — подписанная сборка для устройства.

Для управления нужны MCP-инструменты плагина или установленная CLI `terminal-phone`. Скилл сначала считывает экран, затем выбирает элемент по accessibility ID или точной метке и проверяет результат по условию. Ссылки на элементы устаревают после нового действия или снимка, поэтому их нельзя повторно использовать. Реальный iPhone начинает работу в режиме просмотра: ввод включает только владелец устройства. Пароли и личные данные вводятся лишь для теста по запросу пользователя.

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add govijr/terminal-phone
```
В чате агента (не в терминале):
```text
/plugin install terminal-phone@terminal-phone
```
Команда ставит плагин terminal-phone целиком, со всеми его скиллами

2. **Через Skills CLI (Vercel)**
```bash
npx skills add govijr/terminal-phone --skill terminal-phone -a claude-code
```

3. **Вручную: положить файлы**
- Файл: `~/.claude/skills/terminal-phone/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/terminal-phone/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add govijr/terminal-phone --skill terminal-phone -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/terminal-phone/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add govijr/terminal-phone --skill terminal-phone -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/terminal-phone/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install govijr/terminal-phone plugins/terminal-phone/skills/terminal-phone
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/terminal-phone/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add govijr/terminal-phone --skill terminal-phone -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/govijr/terminal-phone --path plugins/terminal-phone/skills/terminal-phone
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/terminal-phone/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/govijr/terminal-phone/tree/HEAD/plugins/terminal-phone/skills/terminal-phone/SKILL.md

## Когда брать
- установить и открыть iOS-приложение на симуляторе
- пройти экранный сценарий и проверить результат действия
- снять экран или записать демонстрацию приложения
- прочитать логи приложения на телефоне

## Примеры запросов агенту
- Установи и открой приложение из проекта на симуляторе `work`.
- Пройди экран входа в приложении и проверь, что появилось приветствие.
- Сделай снимок экрана приложения и сохрани его в `shot.png`.

## Похожие
- [mirroir-mcp](https://affpapa.org/nevibecode/mcp/mirroir-mcp.md) — MCP-сервер · ★ 400 у репозитория
- [argent-ios-device-setup](https://affpapa.org/nevibecode/skills/argent-ios-device-setup.md) — скилл · 17100 установок
- [ios-device-automation](https://affpapa.org/nevibecode/skills/ios-device-automation.md) — скилл · 3500 установок
- [limrun-ios-simulator](https://affpapa.org/nevibecode/skills/limrun-ios-simulator.md) — скилл · 45300 установок
- [argent-ios-simulator-setup](https://affpapa.org/nevibecode/skills/argent-ios-simulator-setup.md) — скилл · 32700 установок
- [orca-emulator](https://affpapa.org/nevibecode/skills/orca-emulator.md) — скилл · 6300 установок

Из того же набора: [govijr/terminal-phone](https://affpapa.org/nevibecode/by/govijr/terminal-phone.md) — 2 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
