pranshuchittora/simvynУниверсальный мобильный инструмент для агентов и людей — управляйте симуляторами iOS, эмуляторами Android и реальными устройствами из единой панели управления и CLI
Универсальный инструмент для мобильной разработки — управляйте симуляторами iOS, эмуляторами Android и реальными устройствами из единой панели управления и CLI
npx simvyn
Запускает локальный сервер, открывает веб-панель в браузере и автоматически обнаруживает все подключённые симуляторы, эмуляторы и физические устройства, подключённые по USB.
## Установка
**Глобальная установка:**```bash
npm install -g simvyn
Одноразовое использование (без установки):```bash npx simvyn
**Требования:**
- Node.js 22 (22.14.0+) или 24+
- macOS (полная поддержка iOS + Android) или Linux (только Android)
## AI-агенты для программирования
simvyn включает портативный [Agent Skill](https://github.com/pranshuchittora/simvyn/blob/main/skills/simvyn/SKILL.md) для обнаружения устройств, запуска поддерживаемых CLI-команд, создания скриншотов, просмотра данных приложений и сбора ограниченных логов. Он учит агента использовать CLI с явными идентификаторами устройств и ограничениями платформы. Навык использует существующий терминальный инструмент агента; он не регистрирует MCP-сервер или новые инструменты агента.
**Pi:** пакет npm является [пакетом Pi](https://pi.dev/packages/simvyn). Вместе с навыком он добавляет инструменты `simvyn`, `simvyn_screenshot`, `simvyn_logs` и `simvyn_record`, команду `/simvyn`, запускающую дашборд, а также шаблоны промптов `/simvyn-repro`, `/simvyn-screen` и `/simvyn-logs`. Требуется Pi 0.74 или новее:```bash
pi install npm:simvyn
Другие совместимые агенты: установите портативный навык с GitHub, выбрав своего агента, и отдельно установите CLI simvyn:```bash npm install -g simvyn npx skills add pranshuchittora/simvyn --skill simvyn --agent codex --yes
Команда GitHub требует наличия этих файлов навыков в ветке по умолчанию; команда Pi требует наличия ресурсов Pi в опубликованном релизе npm. Для невыпущенных изменений используйте [инструкции по локальной проверке](https://github.com/pranshuchittora/simvyn/blob/main/docs/agents.md#test-an-unreleased-checkout).
См. [руководство по настройке и рабочему процессу агента](https://github.com/pranshuchittora/simvyn/blob/main/docs/agents.md) для встроенного лаунчера, поддерживаемых выходных данных, неинтерактивной работы и текущих ограничений. Также доступен компактный [индекс документации](https://github.com/pranshuchittora/simvyn/blob/main/llms.txt) для инструментов, принимающих URL-адреса документации.
## Возможности
- **Управление устройствами** — Обнаружение, загрузка, выключение, стирание, создание и клонирование симуляторов, эмуляторов и физических устройств с закреплением избранного
- **Управление приложениями** — Установка, запуск, завершение, удаление приложений через drag-and-drop или CLI
- **Просмотр логов** — Потоковая передача в реальном времени с фильтрацией по уровню, поиск по странице (Cmd+F), поиск по регулярным выражениям, пагинация и экспорт
- **Симуляция местоположения** — Установка GPS-координат, воспроизведение маршрутов GPX/KML с контролем скорости, сохранение избранного
- **Настройки устройства** — Тёмный режим, локаль, ориентация, разрешения, переопределения строки состояния, пресеты доступности
- **Скриншоты и запись** — Захват скриншотов и запись видео экрана с историей
- **Deep Links** — Открытие URL-адресов и пользовательских схем, сохранение избранного для каждого приложения
- **Инспектор баз данных** — Просмотр таблиц SQLite, выполнение SQL-запросов, просмотр SharedPreferences и NSUserDefaults
- **Файловый браузер** — Просмотр песочниц приложений, загрузка/скачивание файлов, редактирование текста на месте
- **Push-уведомления** — Составление JSON-полезных нагрузок, отправка на симуляторы iOS, библиотека шаблонов
- **Коллекции** — Объединение действий устройства в повторно используемые последовательности, применение к нескольким устройствам одновременно
- **Журналы сбоев** — Диагностические отчёты iOS и сбои logcat/tombstone Android
- **Буфер обмена** — Чтение и запись содержимого буфера обмена устройства
- **Медиа** — Добавление фотографий и видео в фотоплёнку и галереи устройства
- **Настройки инструмента** — Конфигурация сервера, управление хранилищем, диагностика и отчёты об отладке
- **Поддержка реальных устройств** — Подключение физических устройств Android и iOS через USB с автоматическим обнаружением
- **Веб-панель** — Дизайн Apple Liquid Glass с палитрой команд, навигацией с клавиатуры
- **Полный CLI** — Каждая функция работает без графического интерфейса через `simvyn <command>`
## Демонстрации модулей
### Управление устройствами
Обнаруживайте все подключённые симуляторы iOS, эмуляторы Android и физические устройства с USB-подключением в одном унифицированном списке. Загружайте, выключайте и стирайте устройства без использования Xcode или Android Studio. Создавайте новые симуляторы iOS, выбирая тип устройства и среду выполнения, или клонируйте существующий для быстрого создания дубликатов. Физические устройства появляются автоматически при подключении и группируются отдельно в селекторе устройств.
<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/2b85641878f6015c248311700a1a87a20476ade6c930273a3e47f288a82d6d2e.png" alt="Device Management" width="700" /></p>
- Список всех доступных симуляторов, эмуляторов и физических устройств на всех платформах
- Загрузка, выключение и стирание устройств одним кликом или командой CLI
- Создание новых симуляторов iOS с выбором типа устройства и среды выполнения
- Клонирование и переименование существующих симуляторов
- Закрепление избранных устройств в верхней части селектора устройств
- Обновление состояния устройств в реальном времени через WebSocket
### Управление приложениями
Устанавливайте, запускайте, завершайте и удаляйте приложения на любом подключённом устройстве. Перетаскивайте IPA, APK или .app-бандлы симулятора iOS прямо на панель. Просматривайте подробную информацию о приложении и очищайте данные приложения без ручных команд adb или simctl.