pranshuchittora/simvynУниверсальный мобильный инструмент для агентов и людей — управляйте симуляторами iOS, эмуляторами Android и реальными устройствами из единой панели управления и CLI
<p align="center"> <img src="https://assets.kitploit.com/production/public/readmes/12264/e081fb1d4bcaa6556ff10e722d1ff25449288b68ce1aad9ac3b5ecc047ccf5fb.png" width="180" alt="simvyn" /> </p> <h1 align="center">simvyn</h1> <p align="center"> Универсальный инструмент для мобильной разработки — управляйте симуляторами iOS, эмуляторами Android и реальными устройствами из единой панели управления и CLI </p> <p align="center"> <a href="https://www.npmjs.com/package/simvyn"><img src="https://img.shields.io/npm/v/simvyn?color=cb3837&logo=npm" alt="npm version" /></a> <a href="https://www.npmjs.com/package/simvyn"><img src="https://img.shields.io/npm/dm/simvyn?color=cb3837&logo=npm" alt="npm downloads" /></a> <a href="https://github.com/pranshuchittora/simvyn/actions/workflows/ci.yml"><img src="https://github.com/pranshuchittora/simvyn/actions/workflows/ci.yml/badge.svg" alt="CI status" /></a> <a href="https://github.com/pranshuchittora/simvyn/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/simvyn?color=blue" alt="MIT License" /></a> <a href="https://nodejs.org"><img src="https://img.shields.io/node/v/simvyn?color=5FA04E&logo=node.js&logoColor=white" alt="Node version" /></a> </p> <p align="center"> <img src="https://assets.kitploit.com/production/public/readmes/12264/bff45a80ced8a6cba77f5bab23f21607fb310862cbc838179d9ce714a1d4d6b6.png" alt="simvyn dashboard" /> </p> <p align="center"> <img src="https://raw.githubusercontent.com/pranshuchittora/simvyn/main/assets/demo.gif" alt="simvyn demo" /> </p> ## Содержание - [Быстрый старт](#quick-start) - [Установка](#installation) - [ИИ-агенты для программирования](#ai-coding-agents) - [Возможности](#features) - [Демонстрация модулей](#module-showcases) - [Руководство по коллекциям](#collections-guide) - [Справочник CLI](#cli-reference) - [Как это работает](#how-it-works) - [Поддерживаемые платформы](#supported-platforms) - [Участие в разработке](#contributing) - [Безопасность](#security) - [Лицензия](#license) ## Быстрый старт```bash 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. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/17757b1ca8ddd41d43ac3a159260598308da6c3f759e1c9d730f61498e18ce8a.png" alt="App Management" width="700" /></p> - Установка IPA, APK и .app симулятора iOS через drag-and-drop - Запуск, завершение и удаление приложений по bundle ID - Просмотр деталей приложения, включая версию, размер и разрешения - Очистка данных приложения на устройствах Android - Список всех установленных приложений с фильтрацией поиска ### Просмотр логов Потоковая передача логов устройства в реальном времени с мощной фильтрацией. Фильтруйте по уровню логов, ищите по шаблонам регулярных выражений и фильтруйте по имени процесса. Используйте поиск по странице (Cmd+F) для подсветки конкретных записей без скрытия окружающего контекста. Экспортируйте отфильтрованные логи для обмена или архивирования. Пагинированная история позволяет прокручивать тысячи записей без проблем с производительностью. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/b909b3515637b4059ebf210c56599f2f022506f09ee35a11e812bd8368d3750e.png" alt="Log Viewer" width="700" /></p> - Потоковая передача логов в реальном времени через WebSocket - Фильтрация по уровню: debug, info, warning, error, fatal - Поиск по странице (Cmd+F) с подсветкой совпадений, навигацией и счётчиком - Поиск по регулярным выражениям и фильтрация по имени процесса - Пагинированная история с виртуальной прокруткой - Экспорт отфильтрованных логов в файл - Пауза/возобновление потоковой передачи логов с сохранением состояния между очистками ### Местоположение Устанавливайте точные GPS-координаты на любом устройстве с помощью интерактивной карты или ручного ввода. Воспроизводите файлы маршрутов GPX и KML с регулируемым контролем скорости. Сохраняйте часто используемые местоположения как избранное для быстрого доступа. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/47842dfa878ffbc80bd5bb32d83e820e7ed7dd56a4d63368ca6e823ef72889d4.png" alt="Location" width="700" /></p> - Интерактивная карта с установкой координат по клику - Воспроизведение файлов маршрутов GPX и KML с контролем скорости - Избранные местоположения, сохраняемые для каждого устройства - Широковещательная передача местоположения на несколько устройств - Обратное геокодирование для удобочитаемых адресов ### Настройки устройства Переключайте тёмный режим, меняйте локаль, поворачивайте ориентацию устройства (Android), управляйте разрешениями приложений и переопределяйте внешний вид строки состояния. Применяйте пресеты доступности для тестирования вашего приложения в различных условиях. Все изменения настроек вступают в силу немедленно на целевом устройстве. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/d3f6a33c17b773560072f7b94b71abd5ebc82786c073bdeb6d25f828c3f214fa.png" alt="Device Settings" width="700" /></p> - Переключение тёмного/светлого режима - Изменение локали устройства - Управление разрешениями приложений - Переопределение строки состояния (время, батарея, сигнал) - Пресеты доступности (жирный текст, повышение контраста, размер контента) ### Скриншоты и запись Захватывайте скриншоты и записывайте видео экрана на любом устройстве. Все захваты сохраняются с временными метками и организуются в просматриваемую историю. Скачивайте или удаляйте захваты прямо с панели. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/58ed8f25d148ed53f39066e42be730f255235dbec47539bbec826c455cba7936.png" alt="Screenshots and Recording" width="700" /></p> - Захват скриншота одним кликом - Запись экрана с элементами управления запуском/остановкой - История захватов с временными метками - Скачивание и удаление захватов с панели ### Deep Links Открывайте URL-адреса и пользовательские URI-схемы на любом устройстве. Сохраняйте часто используемые deep links как избранное, организованное по приложениям. Тестируйте обработку deep links вашего приложения без ручного ввода URL-адресов в терминале. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/3a990ef7c74f83c93b63c1654f74b3fa952b0b41abd31fe688cdaf2e29570f62.png" alt="Deep Links" width="700" /></p> - Открытие любого URL-адреса или пользовательской схемы на устройстве - Сохранение избранных deep links для каждого приложения - История ссылок с сортировкой по последним - Работает как с iOS, так и с Android ### Инспектор баз данных Просматривайте базы данных SQLite внутри песочницы любого приложения. Просматривайте схемы таблиц, выполняйте произвольные SQL-запросы и инспектируйте SharedPreferences (Android) или NSUserDefaults (iOS). Редактируйте значения на месте без написания скриптов. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/4884b688dbbee5f1a34b0454950f4d6562e74efdbbb3b84ca5c626835b4b7d37.png" alt="Database Inspector" width="700" /></p> - Просмотр таблиц SQLite с сортируемыми столбцами - Выполнение произвольных SQL-запросов - Просмотр и редактирование SharedPreferences и NSUserDefaults - Редактирование ячеек на месте с определением типа ### Файловый браузер Просматривайте файловую систему песочницы любого установленного приложения. Перемещайтесь по каталогам, загружайте и скачивайте файлы, редактируйте текстовые файлы на месте. Передавайте файлы между вашей машиной и устройством без ручных команд adb pull/push. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/7b7ba540ad5de8b575da4f9bb28694dc68f5ffce51225a388788b8ef2f4767a0.png" alt="File Browser" width="700" /></p> - Просмотр каталогов песочницы приложения - Загрузка и скачивание файлов - Редактирование текстовых файлов на месте - Работает с контейнерами приложений как iOS, так и Android ### Push-уведомления Составляйте JSON-полезные нагрузки push-уведомлений и отправляйте их на симуляторы iOS. Используйте встроенную библиотеку шаблонов в качестве отправной точки или пишите полезные нагрузки с нуля. Валидация JSON в реальном времени подсвечивает ошибки перед отправкой. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/f640654be67c24c7248806987e62908316407c18648fc145109118f260443f7d.png" alt="Push Notifications" width="700" /></p> - Составление и отправка push-полезных нагрузок на симуляторы iOS - Встроенная библиотека шаблонов полезных нагрузок - Валидация JSON в реальном времени - Нацеливание на конкретные приложения по bundle ID ### Коллекции Создавайте повторно используемые наборы действий устройства и применяйте их к нескольким устройствам одновременно. Коллекции объединяют такие шаги, как установка местоположения, переключение тёмного режима и установка приложения, в единый повторяемый рабочий процесс. Три стартовых пресета поставляются с simvyn, чтобы помочь вам начать. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/fbf2ddbba1d3725321c80a914bf5b71ea6a2fc605fddbb73abd0b28385488af6.png" alt="Collections" width="700" /></p> - Создание, дублирование и управление именованными коллекциями - Просмотр категоризированного каталога действий по всем модулям - Изменение порядка шагов через drag-and-drop - Применение к нескольким устройствам с проверкой совместимости - Три встроенных стартовых пресета ### Журналы сбоев Просматривайте диагностические отчёты iOS (файлы .ips) и журналы сбоев Android из logcat и дампов tombstone. Просматривайте записи о сбоях с временными метками и информацией о процессе. Инспектируйте полные детали сбоя без копания в файловых системах устройства. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/8f74a799448050bc37eace1d43865b13f3f47a0997c01dba650fd21e94f09ebf.png" alt="Crash Logs" width="700" /></p> - Разбор диагностических отчётов iOS (.ips) - Группировка сбоев Android logcat по PID и тегу - Получение дампов tombstone Android - Список сбоев с временными метками и детальным просмотром ### Буфер обмена Читайте и записывайте буфер обмена устройства с панели или через CLI. Полезно для быстрой вставки тестовых данных в приложения или инспектирования того, что скопировало приложение. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/db889032abeb5f1d511dcfeb8c06c215bda851436f198a63db97f595b50853d6.png" alt="Clipboard" width="700" /></p> - Чтение текущего содержимого буфера обмена - Запись текста в буфер обмена устройства - Работает с симуляторами iOS и эмуляторами Android ### Медиа Добавляйте фотографии и видео напрямую в фотоплёнку или галерею устройства. Перетаскивайте файлы на панель, чтобы внедрить их без кабелей, электронной почты или облачных передач. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/c63ce5411dc17b5d329c2af381c035d86164f5544928b0c76fe7d05346473561.png" alt="Media" width="700" /></p> - Добавление фотографий и видео в галерею устройства через drag-and-drop - Поддержка больших файлов до 500 МБ - Работает с симуляторами iOS и эмуляторами Android ### Настройки инструмента Настраивайте сервер simvyn, управляйте хранилищем и просматривайте диагностику. Включает генератор отчётов об отладке для подачи проблем. <p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/7ba043d473d21d4bb5477582539ffd9a4c57600ec20c22ee9d7e63146cbbfbb2.png" alt="Tool Settings" width="700" /></p> - Конфигурация порта сервера, автооткрытия и интервала опроса - Обзор использования хранилища с опцией очистки данных - Диагностика: версия Xcode, доступность devicectl, версия adb - Отчёт об отладке одним кликом для подачи багов ## Руководство по коллекциям Коллекции позволяют объединять несколько действий устройства в повторно используемую последовательность и применять их к любой комбинации устройств одним кликом. ### Создание коллекции Откройте панель «Коллекции» на боковой панели. Нажмите **New Collection** и дайте ей имя. Коллекция начинается пустой — вы добавите шаги из каталога действий. ### Добавление шагов Нажмите **Add Step**, чтобы просмотреть категоризированный каталог действий. Действия организованы по модулям — Настройки устройства, Местоположение, Управление приложениями и другие. Выберите действие, настройте его параметры на месте (координаты, bundle ID, значения переключателей), и оно появится в вашей коллекции. Перетаскивайте шаги для изменения их порядка. ### Применение коллекции Нажмите **Apply**, чтобы открыть модальное окно применения. Выберите одно или несколько целевых устройств из списка устройств. Сводка совместимости показывает, какие шаги будут пропущены на несовместимых платформах (например, действия только для iOS на устройстве Android). Нажмите **Cmd+Enter** для выполнения. Матрица статуса в реальном времени показывает прогресс по каждому шагу и каждому устройству в реальном времени. ### Интеграция с палитрой команд Сохранённые коллекции появляются в палитре команд (**Cmd+K**). Найдите коллекцию по имени и примените её напрямую с помощью выбора устройства — не нужно переходить на панель «Коллекции». ### Стартовые коллекции Три встроенных пресета поставляются с simvyn: - **Dark Mode + Japanese Locale** — Включает тёмный режим и устанавливает локаль на японский - **Screenshot Setup** — Настраивает переопределения строки состояния для чистых скриншотов App Store - **Reset Device State** — Очищает местоположение, сбрасывает настройки и стирает данные приложения ### Использование CLI```bash simvyn collections list # List all collections simvyn collections apply <name> <devices...> # Apply a collection to devices ``` ## Справочник CLI Все функции доступны из командной строки. Запустите `simvyn` без аргументов, чтобы открыть панель управления, или используйте любую из команд ниже для работы в headless-режиме. | Команда | Описание | | ------------------------------------------------- | ------------------------------------------ | | `simvyn` | Запустить панель управления (по умолчанию) | | `simvyn device list` | Список всех устройств | | `simvyn device boot <device>` | Загрузить устройство | | `simvyn device shutdown <device>` | Выключить устройство | | `simvyn device erase <device>` | Стереть содержимое и настройки устройства | | `simvyn device create <name> <type> <runtime>` | Создать новый симулятор iOS | | `simvyn device clone <device> <name>` | Клонировать симулятор iOS | | `simvyn device rename <device> <name>` | Переименовать симулятор iOS | | `simvyn device delete <device>` | Удалить симулятор iOS | | `simvyn location set <device> <lat> <lng>` | Задать GPS-координаты | | `simvyn location route <device> <file>` | Воспроизвести маршрут GPX/KML | | `simvyn location clear <device>` | Очистить симулированное местоположение | | `simvyn app list <device>` | Список установленных приложений | | `simvyn app install <device> <path>` | Установить IPA, APK или .app симулятора iOS | | `simvyn app uninstall <device> <bundle-id>` | Удалить приложение | --- [Read more](https://github.com/pranshuchittora/simvyn)
