pranshuchittora/simvynFerramenta móvel universal para Agentes e Humanos - controle simuladores iOS, emuladores Android e dispositivos reais a partir de um único painel e CLI
Ferramenta universal de desenvolvimento mobile — controle Simuladores iOS, Emuladores Android e dispositivos reais a partir de um único painel e CLI
npx simvyn
Inicia o servidor local, abre o painel web no seu navegador e descobre automaticamente todos os simuladores, emuladores e dispositivos físicos conectados via USB.
## Instalação
**Instalação global:**```bash
npm install -g simvyn
Uso único (sem instalação):```bash npx simvyn
**Requisitos:**
- Node.js 22 (22.14.0+) ou 24+
- macOS (suporte completo a iOS + Android) ou Linux (apenas Android)
## Agentes de Codificação com IA
O simvyn inclui uma [Agent Skill](https://github.com/pranshuchittora/simvyn/blob/main/skills/simvyn/SKILL.md) portátil para descobrir dispositivos, executar comandos CLI suportados, capturar screenshots, inspecionar dados de aplicações e recolher logs limitados. Ensina um agente a usar a CLI com IDs de dispositivo explícitos e limites de plataforma. A skill utiliza a ferramenta de terminal existente do agente; não regista um servidor MCP nem novas ferramentas de agente.
**Pi:** o pacote npm é um [pacote Pi](https://pi.dev/packages/simvyn). Juntamente com a skill, adiciona as ferramentas `simvyn`, `simvyn_screenshot`, `simvyn_logs` e `simvyn_record`, um comando `/simvyn` que executa o dashboard, e os templates de prompt `/simvyn-repro`, `/simvyn-screen` e `/simvyn-logs`. Requer Pi 0.74 ou posterior:```bash
pi install npm:simvyn
Outros agentes compatíveis: instale a skill portátil do GitHub, selecionando seu agente, e instale a CLI simvyn separadamente:```bash npm install -g simvyn npx skills add pranshuchittora/simvyn --skill simvyn --agent codex --yes
O comando GitHub exige que estes arquivos de skill estejam presentes no branch padrão; o comando Pi exige os recursos do Pi na versão publicada do npm. Para alterações não lançadas, use as [instruções de checkout local](https://github.com/pranshuchittora/simvyn/blob/main/docs/agents.md#test-an-unreleased-checkout).
Consulte o [guia de configuração e fluxo de trabalho do agente](https://github.com/pranshuchittora/simvyn/blob/main/docs/agents.md) para o launcher incluído, saídas suportadas, operação não interativa e limitações atuais. Um [índice de documentação](https://github.com/pranshuchittora/simvyn/blob/main/llms.txt) compacto também está disponível para ferramentas que aceitam URLs de documentação.
## Recursos
- **Gerenciamento de Dispositivos** — Descubra, inicialize, desligue, apague, crie e clone simuladores, emuladores e dispositivos físicos com fixação de favoritos
- **Gerenciamento de Apps** — Instale, inicie, encerre e desinstale apps via arrastar e soltar ou CLI
- **Visualizador de Logs** — Streaming em tempo real com filtragem por nível, busca na página (Cmd+F), busca por regex, paginação e exportação
- **Simulação de Localização** — Defina coordenadas GPS, reproduza rotas GPX/KML com controle de velocidade, salve favoritos
- **Configurações do Dispositivo** — Modo escuro, localidade, orientação, permissões, substituições da barra de status, predefinições de acessibilidade
- **Capturas de Tela e Gravação** — Capture screenshots e grave vídeo da tela com histórico
- **Deep Links** — Abra URLs e esquemas personalizados, salve favoritos por app
- **Inspetor de Banco de Dados** — Navegue por tabelas SQLite, execute consultas SQL, visualize SharedPreferences e NSUserDefaults
- **Navegador de Arquivos** — Navegue pelos sandboxes dos apps, faça upload/download de arquivos, edite texto inline
- **Notificações Push** — Componha payloads JSON, envie para simuladores iOS, biblioteca de templates
- **Coleções** — Agrupe ações de dispositivos em sequências reutilizáveis, aplique a vários dispositivos de uma vez
- **Logs de Crash** — Relatórios de diagnóstico do iOS e crashes de logcat/tombstone do Android
- **Área de Transferência** — Leia e escreva o conteúdo da área de transferência do dispositivo
- **Mídia** — Envie fotos e vídeos para os rolos de câmera e galerias do dispositivo
- **Configurações da Ferramenta** — Configuração do servidor, gerenciamento de armazenamento, diagnósticos e relatórios de depuração
- **Suporte a Dispositivos Reais** — Conecte dispositivos Android e iOS físicos via USB com descoberta automática
- **Painel Web** — Design Apple Liquid Glass com paleta de comandos, navegação por teclado
- **CLI Completa** — Todos os recursos funcionam de forma headless via `simvyn <command>`
## Demonstrações dos Módulos
### Gerenciamento de Dispositivos
Descubra todos os Simuladores iOS, Emuladores Android e dispositivos físicos conectados via USB em uma única lista unificada. Inicialize, desligue e apague dispositivos sem tocar no Xcode ou Android Studio. Crie novos simuladores iOS escolhendo um tipo de dispositivo e runtime, ou clone um existente para criar duplicatas rapidamente. Dispositivos físicos aparecem automaticamente quando conectados e são agrupados separadamente no seletor de dispositivos.
<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/2b85641878f6015c248311700a1a87a20476ade6c930273a3e47f288a82d6d2e.png" alt="Device Management" width="700" /></p>
- Liste todos os simuladores, emuladores e dispositivos físicos disponíveis entre plataformas
- Inicialize, desligue e apague dispositivos com um clique ou comando CLI
- Crie novos simuladores iOS com seleção de tipo de dispositivo e runtime
- Clone e renomeie simuladores existentes
- Fixe dispositivos favoritos no topo do seletor de dispositivos
- Atualizações de estado do dispositivo em tempo real via WebSocket
### Gerenciamento de Apps
Instale, inicie, encerre e desinstale apps em qualquer dispositivo conectado. Arraste e solte bundles IPA, APK ou .app de simulador iOS diretamente no painel. Visualize informações detalhadas do app e limpe dados do app sem comandos manuais de adb ou simctl.
<p align="center"><img src="https://assets.kitploit.com/production/public/readmes/12264/17757b1ca8ddd41d43ac3a159260598308da6c3f759e1c9d730f61498e18ce8a.png" alt="App Management" width="700" /></p>